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INTRODUCTION 



The Master Control Program for the B 1 700 is responsible for managing the demands and resources of the 
system. The concepts and functions of the MCP cannot be viewed as a series of step-by-step procedures, 
but rather as a series of continuous processes, each capable of functioning independently, but occurring 
simultaneously. 

The purpose of the B 1700 Master Control Program Reference Manual is to provide an insight into the 
operating environment of the B 1 700, and to segregate the internal components of the Master Control 
Program (MCP) in order to analyze their relationship in respect to the overall management of the system. 

The information contained in this manual reflects System Software Release Mark IV.0. 

OVERVIEW OF THE MASTER CONTROL PROGRAM 

The primary function of the Master Control Program (MCP) is to optimize the productivity of the B 1700 
computer system. External intervention is held to the absolute minimum, and maximum throughput is 
achieved by incorporating into the MCP the primary tasks of I/O control, file handling, multiprogramming, 
interrupts, memory allocation, user programs, and operator interface. 

The MCP is mainly disk resident. It consists of many routines and functions, which, when combined, form 
a single program. Because of the size of the MCP, well over a million bits, only those segments of the MCP 
that are needed at a specific time are brought into memory. 

The MCP is written in SDL (Software Development Language) and, therefore, the SDL Interpreter or por- 
tions of it are always active. 

The MCP is an operating system. It manages the demands and resources of the B 1 700 system and reduces 
programming effort by providing a "family" of commonly needed functions and services. The MCP requires 
strict adherence to program structures and procedures in order that there may be communication between 
different programs, interpreters, and the MCP itself. 

COLDSTART, the function performed to initiate the system, structures the system disk as required by the 
MCP, as shown in figure 1. Clear/Start, the function performed to begin processing, structures memory as 
required by the MCP, as shown in figure 2. The first duty of the MCP after a Clear/Start is to perform some 
initialization of its own, after which, it enters its "main loop" and is susceptible to control input. 

LIST OF APPLICABLE B 1700 PUBLICATIONS 

The following is a list of publications relative to the B 1700 and referenced in this manual: 

Publication Title Form No. 

B 1 700 System Software 106873 1 

Operational Guide 

B 1700 System Reference 1057155 

Manual 



vn 




Figure 1. System Disk at COLDSTART 
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Figure 2. B 1 700 Memory After Clear/Start 
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SECTION I 

MCP - PROCESSOR INTERFACE 



MEMORY MANAGEMENT 



There are two different memories within the B 1700 processor: 
(B 1720 series only). 

Control Memory 



Main Memory, and Control Memory 



The MCP and control memory are not directly related and have independent functions relating to the sys- 
tem. The purpose of control memory is to house the microinstructions. The larger the control memory, 
the faster the system throughput, since control memory is up to four times faster than main memory. If a 
set of microinstructions exceeds the available control memory, the MCP stores the overflow in main memory. 
Control memory is available for the B 1720 series of systems only. For a further discussion concerning 
control memory and microinstructions refer to the B 1700 Systems Reference Manual , Form No. 1057155. 

Main Memory 

Main memory is available to all programs, including the MCP. It is addressable to the individual bit and has 
variable operational lengths from 1 to 24 bits. Main memory has no physical word or byte boundaries 
which are visible to the rest of the system. Main memory is shared by all programs requiring it, and is 
divided into variable-size areas. Figure 1-1 illustrates main memory format. 



MCP BASE REGISTER- 



MCP LIMIT REGISTER- 



MCP CONTROL INFORMATION 



FIRST MEMORY LINK 



THIS AREA IS UNRESERVED. 



LAST MEMORY LINK 



THIS AREA IS RESERVED. IT CONTAINS 
THE MCP RUN STRUCTURE NUCLEUS, A 
TABLE OF I/O COMPLETES, AND THE 
CENTRAL SERVICE MODULE CONSTANTS. 



Figure 1-1. Main Memory 



Memory Links 

The memory link, vital to the functional operation of the MCP, is a string of bits containing information 
delimiting the area that the MCP allocates. Memory links contain information such as the size of the area 
allocated, an indication as to what program has control of the block, its usage, and a forward and backward 
reference to adjacent memory links. Table 1-1 describes a memory link format. 
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Table 1-1. Memory Link 



Field Name 



01 MEMORY.LINK 
02 ML.BACK 



02ML.FRONT 



02 ML.SIZE 



Type 



Bit 
Bit 



02 ML.GROUP 
03 ML.POINTER 

03 ML.MIX 

03 ML.SAVE 

03 ML.TYPE 



Bit 



Bit 



Bit 
Bit 

Bit 

Bit 

Bit 



Length 



175 
24 



24 



24 



55 
24 



24 



Description 



Points to the preceding memory 
link. When this is the first memory 
link, ML.BACK contains 
@FFFFFF@. 

Points to the next memory link. 
When this is the last memory link, 
ML.FRONT contains @FFFFFF@. 

Contains the number of bits from 
the end of the memory link to the 
beginning of the next memory 
link. 



Points to the system descriptor 
that refers to the information 
stored in this memory area. 

Contains the program mix number 
using this area. The MCP mix 
number is always zero. 

Indicates whether this field can 
(ML.SAVE=0) or cannot 
(ML.SAVE=1) be overlaid. 

Defines the type of data contained 
within the area. When ML.TYPE 
contains a 2, MEMORY.LINK is 
175 bits; otherwise, it is 163 bits. 

The following is a list of area types: 

Type Code 
Code 

Data 1 

Available 2 

Run structure 3 

MCP (temporary) 4 
User file 5 

Code segment dictionary 6 

Interpreter 7 

Dictionary master 8 

Queue directory 9 

Message buffer 10 

Message list 1 1 
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Table 1-1. Memory Link (Cont) 



Field Name 


Type 


Length 


Description 








Type Code 








Ready to be made 

available 1 2 








Data segment 1 3 


02 ML.AVL 


Bit 


48 




03 ML.F.AVL 


Bit 


24 


Points to the next "available" 
memory link. When this is the 
last link, ML.F.AVL contains 

@FFFFFF@. 


03 ML.B.AVL 


Bit 


24 


Points to the preceding "available" 
memory link. When this is the 
first link, ML.B.AVL contains 

@FFFFFF@. 


02 ML.DISK Remaps ML.AVL 


Bit 


36 


The ML.DISK field, comprised of 
the first 36 bits of the ML.AVL 
field, is the disk address associated 
with the information stored in the 
memory block described by this 
memory link. 



Memory Areas 

Main memory space is classified into two types: available and in-use. Any area not currently being used is 
marked "available." All other areas are considered by the MCP to be "in-use." 

Obtaining Memory Space 

Memory space is obtained by the MCP using the GETSPACE procedure. The various MCP routines that 
reference GETSPACE pass parameters such as the memory size requirement, mix number of the requesting 
program, and the address and type of data to be placed into the memory area. 

GETSPACE then scans memory links, starting at the first memory link, searching for available area. Once 
available space is found (ML.TYPE = 2), a memory link associated with that area is constructed and the 
GETSPACE routine is exited, returning that memory address to the routine that requested the space. If no 
space is available, (ML.TYPE f 2), GETSPACE returns @FFFFFF@. The MCP, depending on the situation, 
can overlay areas to obtain a large enough contiguous area of memory. 

Available areas (ML.TYPE = 2) can be used by any program, including the MCP. In most cases the avail- 
able area is larger than the actual space needed. Since it is, however, inefficient to allocate more memory 
than required, the MCP allocates only the required space and then delimits the area with memory links. 
Figure 1-2 depicts a typical memory map. 

First and Last Memory Links 

The MCP maintains the address of the first and last memory links. These links, referred to as dummy links, 
make it possible to scan total memory by delimiting the scanning search technique. 



1-3 



MCP BASE REGISTER- 




MCP LIMIT REGISTER- 



CSM AND MCP CONTROL INFORMATION 



FIRST MEMORY LINK (DUMMY LINK) 



MEMORY LINK 



MEMORY LINK 




MEMORY LINK 




MEMORY LINK 




LAST MEMORY LINK (DUMMY LINK) 



MCP RUN STRUCTURE NUCLEUS 



Figure 1-2. Typical Memory Map 



Overlayable/Non-Overlayable Data 

The MCP, when unable to find sufficient area to allocate during its first search through memory, then seeks 
for those areas that can be overlaid, which in most cases are areas that already have copies on disk, such as 
code segments. All program code is overlayable because it has copies on disk. When a code segment is 
overlaid, the starting disk address, contained in ML.POINTER, is returned to the respective Code Segment 
Dictionary entry. That dictionary entry is then marked "not present," indicating the code is not residing 
in memory. The memory link field, ML.TYPE, is then marked "available" and the area is free to be used. 
When data other than code has to be overlaid, a copy is written to disk before the area is made available if 
a copy does not already exist. The MCP does have the ability to combine contiguous overlaid areas in order 
to provide the requested space. 

INTERRUPTS 

A B 1 700 interrupt is discovered by the interpreter and handled by the Central Service Module (CSM) or 
the Master Control Program. Interrupts on the B 1 700 are not serviced by hardware functions but by 
system software. This function is termed a "soft" interrupt; therefore, the term "interrupt" implies a 
"soft" interrupt unless otherwise specified. 
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B 1700 interrupts are classified into two types: external and program dependent. Interrupts, per se, are 
discovered by interpreters during their fetch cycle (the process of decoding an S-op). 

When discussed in conjunction with the MCP, interrupts can seem ambiguous in that the MCP never "sees" 
processor interrupts as such. They are intercepted by the interpreters and, if necessary, translated into com- 
municates for the MCP in the following categories. 

a. Program-generated communicates 

b. Interpreter-generated communicates. 

c. CSM-generated communicates. 
The CSM-generated communicates include : 

a. Pointers to I/O descriptors representing I/O interrupts. 

b. Entries representing Code Segment Dictionary addresses for needed MCP segments. 

c. Run Structure Nucleus Communicate Message Pointers of normal state object programs indicating 
one of the following: 

1 . Interpreter segment not present. 

2. Code segment not present. 

3. CSM segment not present. 

4. Data segment not present. 

5. Hi-priority I/O complete. 

6. Trace print. 

Table 1-2 describes the types of interrupts and the methods in which they are handled. 

Table 1-2. Interrupt-Handling on the B 1700 



Type of 
Interrupt 


MCP Control 


User Program Control 


Interpreter 
Function 


CSM 

Function 


Interpreter 
Function 


CSM 
Function 


SERVICE 
REQUEST 

TIMER 

I/O 
INTERRUPT 


Passes control 
to CSM. 

Passes control 
to CSM. 

Passes control 
to CSM. 


Yields control to I/O 
driver; then returns 
to interpreter. 

Increments Timer 
and returns control 
to MCP. 

Stacks the I/O request 
and returns control to 
MCP. 


Passes control to 
CSM. 

Passes control to 
CSM. 

Passes control to 
CSM. 


Yields control to I/O 
driver; then returns 
to interpreter. 

Increments Timer. If 
overflow occurs, 
return is to the MCP; 
if not, return is to the 
interpreter. 

Stacks the I/O request 
and returns to the MCP. 
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Table 1-2. Interrupt-Handling on the B 1700 (Cont) 



Type of 


MCP Control 


User Program Control 


Interpreter 


CSM 


Interpreter 


CSM 


Interrupt 


Function 


Function 


Function 


Function 


MEMORY 


Causes halt and 




Builds the message 




PARITY 


display. 




and returns to MCP. 




OUT OF 


Causes halt and 




Builds the message 




BOUNDS 


display. 




and returns to MCP. 




CONSOLE 


Causes halt and 




Causes halt and 




HALT 


display. 




display. 




PROGRAM 


Causes halt and 




Builds the message 




DEPENDENT 


display. 




and returns to MCP. 





Program Communicates 

All information in a program communicate is contained within the memory area allocated to the program 
with the communicate message pointer of the program referencing the address and size of the communicate 
message. This differs from interrupt communicates in that the interrupt message is contained within the 
communicate itself. Table 1-3 describes the type of program communicates (RS.ITYPE = 01) referenced 
by the message pointer in the Run Structure Nucleus. 



Table 1-3. Program Communicates 



Type Code 


Description 


Type Code 


Description 





Undefined 


12 


Access File Information Block 


1 


Read 


13 


Data overlay 


2 


Write 


14 


Access disk file reader 


3 


Seek 


15 


Undefined 


4 


Sorter control 


16 


Undefined 


5 


Sorter read 


17 


Undefined 


6 


Undefined 


18 


Undefined 


7 


Undefined 


19 


Undefined 


8 


Open file 


20 


Terminate (End-of-Job) 


9 


Close file 


21 


Undefined 


10 


Position file 


22 


Time or date 


11 


Access File Parameter Block 


23 


Undefined 
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Table 1-3. Program Communicates (Cont) 



Type Code 


Description 


Type Code 


Description 


24 


Snooze 


35 


Freeze /Unfreeze 


25 


ZIP 


36 


Compile card information 


26 


Accept 


* 37 


Dynamic Memory Base 


27 


Display 


38 


Memory Dump 


28 


USE return 


39 


Undefined 


29 


Sort handler 


40 


Undefined 


30 


Trace 


41 


Data Comm Queue; 
Data Comm Write 


31 


Undefined 










42 


Data Comm Wait 


32 


COBOL abnormal end 










43 


Undefined 


33 


Sort End-of-Job 










44 


Program call 


34 


Undefined 










45 


Stack size change 



Program-Dependent Interrupts 

Program-dependent interrupts are generated in response to conditions detected by the interpreter of the 
program, but need not be explicitly issued by the object program. The interpreter builds the communicate 
message and places it into the communicate message pointer field of the Run Structure Nucleus and then 
returns control to the MCP. Table 1-4 describes the types of program-dependent interrupts (RS.ITYPE=00). 
The format of the communicate message is as follows: 





RS.COMMUNICATE.MSG.PTR 


Description: 


Interrupt 
Identifier 


Type 


Not Used 


Address 

(If Required) 


Field Length, 
in Bits: 


2 


6 


16 


24 


Identifier: 


RS.ITYPE 


RS.INMBR 


RS.ILENGTH 


RS.IADDRESS 
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Table 1-4. Program-Dependent Interrupts 



RS.ITYPE 


Definition 


RS.ITYPE 


Definition 





Undefined 


19 


Exponent overflow 


1 


Evaluation/Program Pointer 
stack overflow 


20 


Exponent underflow 






21 


Expression out of range 


2 


Control stack overflow 










22 


Superfluous exit 


3 


Name/Value stack overflow 










23 


Out of memory space 


4 


Remap size error 










24 


Invalid link 


5 


Invalid parameter 










25 


Type error 


6 


Invalid substring 










26 


Integer overflow 


7 


Invalid subscript 










27 


Message transfer data not 


8 


Invalid return 




present 


9 


Invlaid case 


28 


Message transfer invalid data 
template 


10 


Divide by zero 










29-56 


Not used 


11 


Invalid index 










57 


Sizechange cleanup 


12 


Read out-of-bounds, memory 








parity 


58 


Interpreter segment not 
present 


13 


Invalid operator 










59 


Hi-priority Reader/Sorter 


14 


Invalid parameter to value 
descriptor 




complete 






60 


Put in ready queue (response to 


15 


Convert error 




timer overflow or I/O Interrupt) 


16 


Stack overflow 


61 


Trace print 


17 


Uninitialized data item 


62 


Code segment not present 


18 


Write out-of-bounds 


63 


Data segment not present 




NO 


TE 




On 


types 58, 62, and 63, the address of t 


ae system descr 


iptor causing the "not 


pre 


sent" interrupt is in the address part o 


f the communi 


sate message. 



All program-dependent interrupt types less than 57 cause the program involved to discontinue processing. 
This action is relayed by the MCP to the console printer, with a message stating the problem, the current 
value of the next instruction pointer (NIP), and termination information. If the TERM option is set, the 
MCP automatically terminates the program without operator intervention. 
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External Interrupts 

External interrupts are those not having any connection with a particular program or job being processed 
at the time the interrupt occurs. Below are those interrupts that can be classified as external. 

a. Timer. 

b. I/O service request. 

c. Memory parity error. 

d. Memory out-of-bounds condition. 

e. I/O interrupt. (Different from item b, above, because of apparent violation of base and limit 
registers.) 

Each of the above conditions generates an interrupt bit and is recognized by the examination of the appro- 
priate bits in the CC or CD registers. (Refer to the B 1700 System Reference Manual , Form No. 1057155.) 
In addition to the individual interrupt bits developed, the XYST register has a bit referenced as the INT 
(INTERRUPT OR), which indicates that one or more of the interrupt conditions are true. The CSM first 
tests the INT bit of the XYST register; if INT is true, the CSM then examines other bits to determine 
specifically what caused the interrupt. If the CSM finds the INT bit false, no further checking is needed. 

Interrupt and Communicate Servicing 

The handling of an interrupt is accomplished by the outermost loop of the MCP, which gains control and 
performs the following functions: 

a. Handles unprocessed I/O interrupts via the NUTHIN.TDO and IOCOMPLETE procedures. 

b. Updates the system clock. 

c. Checks the ACTIVE SCHEDULE for programs waiting to be executed. 

d. Empties the Communicate queue by calling the program handler (IH procedure). 

e. Reinstates programs in the Ready queue. 

MCP Non-Processing Mode 

The MCP remains in its "outer loop" while waiting for processing. Basically the outer loop performs the 
following: 

a. If the system clock is greater than the next timer overflow interval, N. SECOND is called. 

b. The MCP then enters a routine called NUTHIN.TDO and passes it a zero, causing any interrupts 
in the Interrupt queue to be processed by the IOCOMPLETE routine. 

c. The MCP then checks for an entry in the active schedule; if there is, the FIREPROG routine 
attempts to execute the program. 

d. If there is art entry in the Communicate queue, the MCP processes the communicate (IH 
procedure). 

e. If there is a program in the Ready queue, the MCP attempts to reinstate the program. When the 
routine, M.REINSTATE, relinquishes control, the MCP processes the communicate (in the IH 
procedure) caused by M.REINSTATE when it relinquished control. 

f. The above functions perform in a continuous manner, forming the "outer loop." 
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SYSTEM INITIALIZATION 

Before processing can begin, the system must be initialized. This consists of loading the Master Control 
Program, Central Service Module, and the SDL Interpreter. A Clear/Start then readies the system for 
operation. 

Procedures for COLDSTART 

COLDSTART is the name of the routine used to initialize a B 1 700 system. There are four basic steps to 
COLDSTART: 

a. Constructing and initializing the Disk Directory and available tables on the system disk. 

b. Loading the MCP to the system disk. 

c. Loading the SDL Interpreter and the CSM for the B 1710 and B 1 720 systems, as well as the 
programs SYSTEM/INIT, SYSTEM/LOAD.DUMP, FILE/LOADER, and SYSTEM/MEM.DUMP. 

d. Displaying a message to the operator to perform a Clear/Start. COLDSTART creates a table that 
contains the variables needed by Clear/Start for processing control. 

Table 1-5 describes the COLDSTART variable table used by the MCP. 

Table 1-5. COLDSTART Variables 



Field Name 


Type 


Length 


Description 


01 COLD.START.VARIABLES 


Bit 


664 




02 CLEAR.START.FLAGS 






The following flags are used at 
Clear /Start to initialize the system. 
The flags are pointers to the files 
needed, and being used, during the 
initialization. 


03 CS.TRACT 
03 CS.INTERP 
03 CS.MCP 
03 CS.GISMO (CSM) 


Bit 
Bit 
Bit 
Bit 


4" 
4 
4 
4, 


» 


CS.INTERP, CS.MCP, CS.GISMO, 
and CS.INIT are local indices set 
by Clear /Start to indicate which 
file within a particular category 
was selected. 


03 CS.INIT 


Bit 


4 


On system disk resides a directory 
from which Clear/Start selects the 
files needed to initialize the sys- 
tem. The directory format is an 
array of 40 36-bit disk addresses 
(one segment) followed by 36 
30-character name entries (six 
segments). Following this direc- 
tory are the files referenced by 
the above pointers. 










Following are the files referenced 
by CS.INIT. 



1-10 



Table 1-5. COLDSTART Variables (Cont) 



Field Name 


Type 


Length 


Description 








Code 


File 








= 


Standard system 
initializer 








1 = 


Entry system (MCPI) 
initializer 








2 = 


Experimental system 
initializer 








3 = 


B 1710 series CSM 








4 = 

5 - 

6 = 


B 1 720 series CSM 








Entry system (MCPI) 








7 = 


B 1710 series trace CSM 








8 - 


B 1 720 series trace CSM 








9 = 










10 = 


Entry system (MCPI) 
trace CSM 








11 = 


Experimental CSM 








12 = 


B 1710 series MCP 
interpreter 








13 = 


B 1 720 series MCP 
interpreter 








14 = 


Entry system (MCPI) 
interpreter 








15 = 


B 1710 series MCP trace 
interpreter 








16 = 


B 1 720 series MCP trace 
interpreter 








17 = 


Entry system (MCPI) 
trace interpreter 








18 = 


Experimental MCP 
interpreter 




• 




19 = 


Standard MCP 
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Table 1-5. COLD START Variables (Cont) 



Field Name 



Type 



Length 



Description 



02 NAME.TABLE 

02 INTERP.DIC.ENTRIES 
02 CS.SIZE 
02 DUMP.FILE 

02 PAGE.SIZE 



02 MPF.TABLE 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



36 

24 
24 
24 

24 



36 



20 = Entry MCP (MCPI) 

21 = Trace MCP 

22 = Entry trace MCP (MCPI) 

23 = Experimental MCP 

24 = Stand-alone memory 

dump 

25 = Stand-alone entry 

(MCPI) memory dump 

26 = Stand-alone disk dump 

27 = Stand-alone SDL 

program 

28 = Stand-alone I/O debug 

29 = Loader for stand-alone 

SDL program 

30 = Experimental stand- 

alone program (MIL) 

Contains the beginning disk 
address of the files listed under 
CS.INIT. 

Contains the number of entries in 
the Interpreter Dictionary. 

Contains the length of the 
COLDSTART variable table. 

Points to the disk address con- 
taining a memory dump 
(SYSTEM/DUMPFILE). 

Contains a page size in Control 
Memory. This is referenced when 
interpreters are being swapped in 
and out of Control Memory. 

Contains a disk address pointing 
to the first entry in the multiple 
pack file table. When more than 
one multiple pack file is present, 
forward/backward links connect 
the additional multiple pack file 
table entries. 
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Table 1-5. COLD START Variables (Cont) 



Field Name 


Type 


Length 


Description 


02 LOG.MIX.INFO 


Bit 


36 


References the time, number of 
disk accesses, the log address, and 
mix number of each job on the 
system. For a Clear/Start the 
MCP uses this data to update the 
log. 


02 DISK .AVAIL 


Bit 


36 


Contains the disk address of the 
Working Available table. 


02 DISK/DIRECTORY 


Bit 


36 


Contains the disk address of the 
Disk Directory. 


02 TEMP.TABLE 


Bit 


36 


Contains the disk address of the 
Temporary Available table. 


02 SYSTEM.D RIVES 


Bit 


16 


Contains 1 6 one-bit fields 
identifying the system disk 
drives present on the system. 
There is a maximum of 1 6 system 
disk drives. 


03 SYSTEM.DRIVE 


Bit 


1 


Elementary field of the above 
structure. 


02 AVL.TABLE.DISP 


Bit 


64 


This field contains 1 6 four-bit 
fields identifying the 1 0-segment 
portion of the Temporary Avail- 
able table assigned to each system 
drive on the system. For example: 
If drive (DPA) and drive 3 (DPD) 
are system drives, the SYSTEM. 
DRIVES bit configuration would 
be 1001000000000000. The 
AVL.TABLE.DISP configuration 
would be 0001000000000000. In 
this example, DPD would be the 
second Temporary Available table 
constructed for the system drive. 


02 SY.DAY 


Bit 


5 


Contains the current day. 


02 SY.MONTH 


Bit 


4 


Contains the current month. 


02 SY.YEAR 


Bit 


7 


Contains the current year. 


02 SY.JDAY 


Bit 


9 


Contains the current day (in 
Julian date format). 


02 SY.TIME 


Bit 


21 


Contains the time in hours, 
minutes, seconds, and tenths of 
seconds. 
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Table 1-5. COLD START Variables (Cont) 



Field Name 


Type 


Length 


Description 


03 SY.HOUR 


Bit 


5 


Contains the hour: 0-23. 


03 SY.MIN 


Bit 


6 


Contains the minute: 0-59. 


03 SY.SEC 


Bit 


6 


Contains the second: 0-59. 


03SY.10THSEC 


Bit 


4 


Contains the tenth of second: 0-9. 


02SY.12HOUR 


Bit 


5 


Contains the hour: 0-12. 


02 SY.DAYNAME 


Char. 


9 


Contains the day of the week. 


02 SY.MERIDIAN 


Char. 


2 


Contains AM or PM. 


02 SYSTEM.OPTIONS 


Bit 


80 


The following options contained 
under SYSTEM.OPTIONS, Lexic 
Level 03, (except those listed 
below) are available and remain in 
a reset condition until set. Those 
which are preset at COLDSTART 
areas follows: 

TIME 

DATE 

BOJ 

EOJ 

TERM 

DUMP 


03 LOG.OPTION 


Bit 


1 


Provides the space on the system 
disk for the log. 


03 CHARGE.OPTION 


Bit 


1 


Requires that all programs sched- 
uled for execution have a 
CHARGE number. 


03 LIB.OPTION 


Bit 


1 


Causes the MCP to display the 
file-identifier for any resultant 
action performed on the file. 


03 OPEN.OPTION 


Bit 


1 


Causes the message, "file-identifier 
OPENED," to be displayed at each 
file open. 


03 TERM.OPTION 


Bit 


1 


Instructs the MCP to automatically 
discontinue (DS) processing a pro- 
gram when an irrecoverable error 
has occurred. (This option 
eliminates the possibility of 
obtaining a memory dump.) 
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Table 1-5. COLDSTART Variables (Cont) 



Field Name 



03 TIME.OPTION 



03 DATE.OPTION 



03 CLOSE.OPTION 



03 PBT.OPTION 



03 PBD.OPTION 



03 BOJ.OPTION 



03 EOJ .OPTION 



03 SCHM. OPTION 



03 LAB .OPTION 



03 RMOV.OPTION 



03 DUMP.OPTION 



Type 



Bit 



Bit 



Bit 



Bit 



Length 



1 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Description 



Causes the message "TR PLEASE" 
to be displayed during a Clear/ 
Start. The operator is required to 
enter the time before processing 
can begin. 

Causes the message "DR PLEASE" 
to be displayed during a Clear/ 
Start. The operator is required to 
enter the date before processing 
can begin. 

Causes the message, "file-identifier 
CLOSED," to be displayed at each 
file close. 

Causes an output file assigned to a 
printer or card punch to be diverted 
to tape backup if the designated 
output device is not available and 
providing the program allows tape 
backup. 

Causes file backup to go to disk 
under the same parameters as the 
PBT.OPTION. 

Causes a BOJ message to be dis- 
played when a program begins 
execution. 

Causes an EOJ message to be 
displayed when a program 
reaches EOJ. 

Causes the MCP to display a 
message when a program is 
placed in the waiting schedule. 

Causes the tape label to be dis- 
played each time a BOT (beginning- 
of-tape mark) is read. 

Automatically causes the removal 
of the "old file" in a duplicate file 
situation. This is similar to the 
"RM" console message. 

Creates a system dump file. If the 
option is reset, the SYSTEM/ 
DUMPFILE is removed from the 
Disk Directory. 
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Table 1-5. COLDSTART Variables (Cont) 



Field Name 


Type 


Length 


Description 


03 ZIP.OPTION 


Bit 


1 


Displays on the console printer all 
ZIP statements that are communi- 
cated to the MCP. 


03 MEM.OPTION 


Bit 


1 


Causes the MCP to display a 
message whenever there is no 
available memory. 


03 SWOl. OPTION 


Bit 


1 


Used for systems software 
debugging. 


03 SW02.0PTION 


Bit 


1 


Used for systems software 
debugging. 


03 SW03. OPTION 


Bit 


1 


Used for systems software 
debugging. 



Disk COLDSTART Variables 

Because of the constant demand for memory space, the infrequently used portions of the COLDSTART 
variables are stored on the systems disk and are read into memory as needed. Table 1-6 contains a list of 
these variables. 



Table 1-6. Disk COLDSTART Variables 



Field Name 


Type 


Length 


Description 


01 DISK.CS. VARIABLES 


Bit 


420 




02 MASTER.IOAT 


Bit 


36 


Contains the disk address of the 
I/O Assignment Table. 


02 MASTER.DISK.AVAIL 


Bit 


36 


Contains the disk address of the 
Master Available Table. 


02 NEXT.LOG.RECORD 


Bit 


36 


Contains the disk address of the 
next available log record. 


02 LOG.SIZE 


Bit 


24 


Contains the remaining size of the 
current area of the log. 


02 NEXT.ELOG 


Bit 


36 


Contains the disk address of the 
Elog (engineering log). 


02 ELOG.SIZE 


Bit 


24 


Contains the size remaining in the 
current area of the Elog. 


02 JOB.NO 


Bit 


24 


Contains the job number that is 
to be assigned to the next program 
executed. 
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Table 1-6. Disk COLD START Variables (Cont) 



Field Name 



02 PBD.NO 

02 DUMP.NO 
02 CTLDCK.NO 
02 LOG.NO 
02 Q.DISK 

02 TRACE.FPB 
02 CTLDCK. DIRECTORY 
02 PBD.BLCKS.AREA 
02 LOG.LAST.AREA 



Type 



Bit 



Bit 



Bit 



Bit 



Bit 



Length 



Bit 



Bit 



Bit 



Bit 



24 

24 
24 
24 
36 

36 
36 

24 



Description 



Contains the next number to be 
assigned to a printer or punch 
backup file. 

Contains the next number to be 
assigned to a dump file. 

Contains the next number to be 
assigned to a pseudo file. 

Contains the next number to be 
assigned to a log file. 

Contains the disk address of work 
areas used by the MCP; for exam- 
ple, program rollouts, disk log, and 
temporary FPBs. 

Contains the disk address of the 
FPB trace skeleton. 

Contains the disk address of the 
pseudo reader directory. 

Contains the blocking factor for 
disk backup files. 

Indicates the last area of the log 
is being used. 



Clear/Start 

The Clear/Start program structures memory and prepares the system for program execution. A Clear/Start 
is performed for the following conditions: 

a. System power-ups. 

b. Unscheduled halts. 

c. Apparent MCP or Interpreter loops. 

d. Operating environment changes. 

The Clear/Start procedure performs the following functions: 

a. Writes correct parity throughout memory. 

b. Loads selected operating environments from the Name Table. (To be discussed later in this 
section.) 
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c. Creates a "run structure" with which the MCP may operate. 

d. Passes control to the MCP. 

Clear/Start can be performed on any system and with either MCP I or MCP II. 
Name Table 

The Name Table, built during COLDSTART, resides on disk and identifies systems software/firmware used 
in the operational environment of the system. The Name Table allows recovery from an experimental mode 
of operation to the standard mode. The COLDSTART procedure loads and identifies the required systems 
software/firmware to begin operations on whatever hardware is available. After a Clear/Start, a systems 
pack may be moved from one system to another, requiring only another Clear/Start to begin processing. 
COLDSTART loads the following systems software /firm ware: 

a. Standard MCP. 

b. SDL Interpreter for the B 1 7 1 series. 

c. SDL Interpreter for the B 1 720 series. 

d. CSM for the B 1 71 series. 

e. CSM for the B 1 720 series. 

f. System Initializer. 

g. SYSTEM/LOAD.DUMP 
h. FILE/LOADER 

i. SYSTEM/MEM.DUMP 

A Clear/Start is required to effect any environment change. The changed systems software/firmware 
becomes the new basis for operation, and remains in effect until changed. However, limited environmental 
switching can be done on a temporary basis during the Clear/Start procedure. Table 1-7 contains the Name 
Table entries. 



Table 1-7. Systems Software/Firmware 



Name Table 
Entry Number 


System 
Mnemonic 


Description 





N 


Standard System Initializer 


1 


NE 


Entry System Initializer. 


2 


NX 


Experimental System Initializer. 


3 


Gl 


B 1710 Central Service Module. 


4 


G2 


B 1720 Central Service Module. 


5 


G3 


Reserved. 


6 


GE 


Entry Central Service Module. 
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Table 1-7. Systems Software/Firmware (Cont) 



Name Table 
Entry Number 



System 
Mnemonic 



7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 

25 
26 
27 
28 
29 

30 



GIT 

G2T 

G3T 

GET 

GX 

II 

12 

IE 

IIT 

I2T 

IET 

IX 

M 

ME 

MT 

MET 

MX 

SD 

SDE 
SDD 
SDL 

SIO 
SL 

SX 



Description 



B 1710 Trace Central Service Module. 

B 1 720 Trace Central Service Module. 

Reserved. 

Entry Trace Central Service Module. 

Experimental Central Service Module. 

B 1710 MCP Interpreter. 

B 1720 MCP Interpreter. 

Entry MCP Interpreter. 

B 1710 MCP Trace Interpreter. 

B 1720 MCP Trace Interpreter. 

Entry MCP Trace Interpreter. 

Experimental MCP Interpreter. 

Standard MCP II. 

Entry MCP (MCPI). 

Trace MCP. 

Entry Trace MCP. 

Experimental MCP. 

Stand-Alone Memory Dump (required for 
any system dumps). 

Stand-Alone Entry Memory Dump. 

Stand-Alone Disk Dump. 

Stand-Alone SDL Program. 

Stand-Alone I/O Debug. 

Loader for Stand-Alone SDL Program (needed 
to load the SDL interpreter). 

Stand-Alone Program (MIL). 
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SECTION 2 

MCP - OBJECT PROGRAM COMMUNICATION 

INTRODUCTION 

The B 1 700 system, whether operating serially (MCPI) or in a multiprogramming environment (MCPII), 
processes object programs generated by B 1700 compilers. This section discusses object programs, compilers, 
code file (object code) structures, and object code execution. 

COMPILATION 

A compiler is a special-purpose computer program which accepts source statements in a language for which 
the compiler was written, and translates those source statements into object code to be stored on disk either 
temporarily or permanently. The compilation process requires specific functions to be performed by the 
compiler and the Master Control Program. Certain control information about the program is stored on disk 
with the program object code. 

Compilation Types 

The COMPILE control statement designates the type of compilation to be performed: 

a. COMPILE . . . (and GO) 

b. COMPILE . . . [TO] LIBRARY 

c. COMPILE . . . SAVE 

d. COMPILE . . . [FOR] SYNTAX 

Refer to the COMPILE statement in the B 1700 System Software Operational Guide , Form No. 1068731, 
for additional information concerning the COMPILE statement. 

MCP-Compiler Recognition 

The COMPILE statement is a request to the MCP to schedule a particular program having special parameters 
for execution. The COMPILE statement is scanned for the type of compilation to be performed. 

OBJECT PROGRAMS 

Compiler output is an object program. Object programs are stored on disk, either temporarily or 
permanently, in executable format. Object program structure consists of various components, some of 
which are optional depending upon requirements of each language. The following terms pertain to object 
programs: 

Term Description 

Object program Output of a compiler containing a Program 

Parameter Block, File Parameter Blocks, 
and object code. 

Object code The executable code in an object program. 

S- C ode The object code that is interpreted by an 

S-machine (discussed later in this section). 

Object program file A disk copy of the object program. 
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An object program file may have one or more of the following components: 

a. Program Parameter Block (required). 

b. Scratchpad area (required), 
c File Parameter Blocks. 

d. S-code (required). 

e. Data Segment Dictionary. 

f. Code Segment Dictionary (required). 

g. Data Segments. 

The Program Parameter Block (PPB) and the scratchpad area (an MCP/object program work area) reside 
the first two disk segments of all code files, as illustrated in figure 2-1 . 



in 



SEGMENT 



SEGMENT 1 



OBJECT CODE 



I (VARIES DEPENDING UPON COMPILER) 




Figure 2-1. MCP/Object Program Work Area Example 

Program Parameter Block (PPB) 

The first disk segment (relative zero) of all code files generated by a compiler is the Program Parameter 
Block (PPB). It contains information and reference addresses needed in the processing of an object 
program, and is classified into two parts: general information, and log information. 

General information is supplied by the compiler during compilation and contains the data required by the 
MCP to schedule a program for execution. At execution time, the MCP expands the PPB from one segment 
to three, supplying additional information needed for execution, for the system log, and for run-time 
control. Table 2-1 describes the Program Parameter Block format. 
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Table 2-1. Program Parameter Block 



Field Name 



01 PROGRAM.PARAMETER.BLOCK 
02 PROGRAM.NAME 

03 PROG.CURRENT.DIRECTORY 

03 PROG.NAME.FIRST 
03 PROG.NAME. SECOND 



02 PROG.INTRINSIC 

03 PROG.INTRINSIC.DIRECTORY 

03 PROG.INTRINSIC.NAME 

02 PROG.INTERP.NAME 

03 PROG.INTERP.DIRECTORY 

03 PROG.INTERP.NAME.FIRST 

03 PROG.INTERP.NAME.SECOND 

02 PROG.PRIORITY 

02 PROG.BEGINNING 



Type 



02 PROG.STATIC.CORE 



Length 



Bit 


2332 


Char 


30 


Char 


10 


Char 


10 


Char 


10 



Char 
Char 

Char 

Char 
Char 

Char 

Char 

Bit 

Bit 

Bit 



20 
10 

10 

30 
10 

10 

10 

4 
32 

24 



Description 



Contains the program-identifier. 

Contains the program pack- 
identifier. 

Contains the program family-name. 

Contains the program file- 
identifier. 

NOTE 

For a compilation, the log copy of 
the PPB contains the program 
name of the compiler. 

Contains the intrinsic file-identifier. 

Contains the intrinsic pack- 
identifier. 

Contains the intrinsic family- 
identifier. 

Contains the interpreter identifier. 

Contains the interpreter pack- 
identifier. 

Contains the interpreter 
family-name. 

Contains the interpreter file- 
identifier. 

Contains the priority of the 
program. (Compiler default = 4.) 

Contains the first instruction 
pointer. 

During compilation the compiler 
calculates the amount of memory 
to be allocated that immediately 
follows the base register of the 
program. During execution if there 
are data segments present, this 
field is the same size that is 
assigned in the first entry of the 
Data Dictionary when the program 
was compiled. If a disk address is 



2-3 



Table 2-1. Program Parameter Block (Cont) 



Field Name 



02 PROG.DYNAMIC.CORE 



02 PROG.TOTAL.CORE 



02 PROG.BIGGEST.SEG 
02 PROG.DATA.DIC 
02 PROG.SEG.DIC 



02 PROG.FPB.ADDRESS 



02 PROG.FILES 

02 PROG.CHARGE.NUMBER 

02 PROG.ONLY.SEG 

02 PROG.FREEZER 

02 PROG.LINKS 



Type 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Length 



24 



24 



24 
64 
64 



24 



24 



10 



Description 



present in the dictionary entry, the 
memory allocated starts from that 
disk address. 

Contains the size of dynamic 
memory. 

Contains the smallest amount of 
memory required to execute the 
program. PROG.TOTAL.CORE 
consists of the following 
components: 

PROG.STATIC.CORE, plus 
PROG.DYNAMIC,CORE, plus 
DATA DICTIONARY SIZE, 

plus the 
FIB DICTIONARY SIZE. 

Contains the size of the largest code 
segment. 

Contains the Data Dictionary 
descriptor. 

Contains the Segment Dictionary 
descriptor. 

NOTE 

A normal descriptor contains the 
position, length, and the type of 
data that is referenced. 

Contains the relative disk address of 
the first FPB in the program file 
(relative to the base of the code 
file). FPBs are contiguous. 

Contains the total number of files 
in program. The maximum is 225. 

Contains the user-assigned charge 
number of the program. 

Reserved for the SDL overlay 
handler. 

Prohibits the program to be rolled- 
out of memory. 

Indicates that memory links are 
needed in the dynamic memory 
area. 
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Table 2-1. Program Parameter Block (Cont) 



Field Name 



02 PROG.TRACE 



02 PROG.SCHED.PRIORITY 



02 PROG.VIRTUAL.DISK 



02 PROG.IPB 
02 FILLER 



Type 



Bit 



Bit 



Bit 



Length 



8 



24 



Description 



Bit 



Bit 



24 



92 



Enable a trace to begin with the 
first executable statement. 

Contains the program scheduling 
priority. 

Contains the number of disk seg- 
ments for data overlays. If the field 
contains zeros and data overlays 
are required, 1 000 disk segments 
are assigned. 

Contains the relative file location of 
the interpreter parameter block. 



NOTE 



The entries above this point are compiler-generated; those entries below this point 
are MCP-generated. 



02 PROG.PROG.PTR 

02 PROG.EXECUTE.TYPE 



Bit 



Bit 



02 PROG.EOJ.TYPE 



36 



Bit 



Contains the absolute disk address 
of the PPB. 

The execution type codes consist of 
the following: 

1 = Execute 

2 = Compile and Go 

3 = Compile for Syntax 

4 = Compile to Library 

5 = Compile and Save 

6 = "Go" part of Compile and Go 

7 = "Go" part of Compile and 

Save 

Contains the condition of program 
termination. 

= Normal end-of-job 

1 = DSorDP 

2 = Error condition in program 

3 = Aborted 
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Table 2-1. Program Parameter Block (Cont) 



Field Name 



02 PROG.GENERATOR.NAME 

03 PROG.GENERATOR. 
DIRECTORY 

03 PROG.GENERATOR.NAME. 
FIRST 

03 PROG.GENERATOR.NAME. 
SECOND 

02 PROG.DATE.COMPILED 



02 PROG.SCHED.LINK 

02 PROG.SCHED.PR.COPY 
02 PROG.SCHED.SIZE 

02 PROG.JOB.NUMBER 

02 PROG.FLAGS 

03 FILLER 

03 PROG.DONT.REENTER 

03 PROG. SORT 

03 PROG.WAIT.OPERATOR 

02 PROG.EX.AFTER.NAME 



03 PROG.EX.AFTER.DIRECTORY 



03 PROG.EX.AFTER.NAME FIRST 



03 PROG.EX.AFTER. 
NAME SECOND 



Type 



Char 
Char 

Char 

Char 

Bit 

Bit 

Bit 
Bit 

Bit 

Bit 

Bit 
Bit 

Bit 
Bit 

Char 



Char 

Char 

Char 
2-6 



Length 



30 
10 

10 

10 

36 

36 

4 

24 

24 



1 

1 

1 
1 

30 



10 



10 



10 



Description 



Contains the compiler-identifier. 

Contains the compiler pack- 
identifier. 

Contains the family -name. 



Contains the compiler file-identifier. 



Contains the date and time program 
was compiled. 

Contains the disk address of the 
next item in the schedule. 

Contain? the scheduled priority. 

Contains the total amount of 
memory required for the scheduled 
job. 

Contains the job number of this 
program. 

Contains MCP internal control 
flags. 

Reserved. 

Indicates that the code segment 
dictionary is non-standard. 

Indicates this is a sort program. 

Indicates this program is waiting 
for response to an "FS" or "RS" 
message. 

Contains points that link condition- 
ally executed programs such as 
EXECUTE.THEN or 
EXECUTE.AFTER to their 
predecessor. 

Contains the pack-identifier for 
the EXECUTE.AFTER program. 

Contains the family-name for the 
EXECUTE.AFTER program. 

Contains the file-identifier for the 
EXECUTE.AFTER program. 



Table 2-1. Program Parameter Block (Cont) 



Field Name 



02 PROG.SORT.DATA 



02 PROG.SORT.SPAD 



02 PROG.MY.MIX 



02 PROG.HIERARCHY 



02 PROG.PRIOR.MIX 



02 PROG. SCHED.D ATE 



02 PROG.BOJ.DATE 



02 PROG.EOJ.DATE 



02 PROG.PROCESS.TIME 



02 PROG.OBJ.NAME 



03 PROG.OBJ.DIRECTORY 



03 PROG.OBJ.NAME.FIRST 



03 PROG.OBJ.NAME.SECOND 



02 PROG.PSEUDO.READER 



02 PROG.PORT.CHAN 



Type 



Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Char 

Char 

Char 

Char 

Bit 

Bit 



Length 



36 
36 
24 
8 
24 
36 
36 
36 
24 
30 
10 
10 
10 
24 



Description 



Contains the disk address of the 
sort parameters. 

Contains disk address of the sort 
area. 

Contains the mix-index number of 
the program. 

Contains nesting Lexic Level for 
the program procedure being used. 

Contains the calling program 
mix-number. 

Contains the date and time the 
program is scheduled for execution. 

Contains the date and time of the 
program BO J. 

Contains the date and time of the 
program EOJ. 

Contains the total processor time 
of the program. 

Indicates the compilation is 
completed. 

Contains the object program 
pack-identifier. 

Contains the object program 
family-name. 

Contains the object program 
file-identifier. 

Contains the beginning address of 
the pseudo reader table. 

Contains the port and channel of 
the disk unit on which the object 
program resides. 



Scratchpad 

The scratchpad is an area generated by the compiler that is utilized by the interpreters during program 
execution. The initial scratchpad resides in the second disk segment of all code files, immediately following 
the Program Parameter Block (PPB). It is the responsibility of the compiler to generate the initial scratch- 
pad settings. The contents of the scratchpad are dependent on the S-language represented by the 
S-machine state during processing. When a program is first permitted to execute, the scratchpad in the 
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processor is loaded from the scratchpad image of the object program on disk. When a program relinquishes 
control, the interpreter stores the scratchpad settings and restores them when the program is reinstated. 
Figure 2-2 contains a skeleton scratchpad format. 



16 



W 

o 

R 
D 
S 



LEFTSIDE 

A 
- 24 BITS 



ADDRESS 



SOOA 



1 



S15A 



RIGHT SIDE 

B 
- 24 BITS ■ 



ADDRESS 



SOOB 
— I — 



S15B 



48 BITS 



Figure 2-2. Skeleton Scratchpad 

Scratchpad, as addressed by an interpreter, may be referenced as sixteen 48-bit words, or thirty-two 24-bit 
words. Refer to the B V700 System Reference Manual , Form No. 1 0571 55, for a detailed explanation of 
the scratchpad and its register-related functions. 

The initial scratchpad settings and the storing and restoring of the processor state of a program are the two 
major functions of the interpreter concerning scratchpad. Since the MCP is also a code file, the only differ- 
ence between its scratchpad and that of an object program is the internal settings; the format and size are 
the same. 

The MCP at program beginning-of-job copies the initial scratchpad settings from disk into the field 
RS.M.MACHINE contained in the Run Structure Nucleus of the program. When the program receives 
control and begins processing, the interpreter loads portions of the RS.M.MACHINE into the processor 
scratchpad. When the program relinquishes control, the interpreter stores the appropriate scratchpad 
settings back into RS.M.MACHINE. The interpreter reloads the scratchpad settings the next time the 
program gains control. 

The S-machine is the processor structure of an object program. The instructions of the object program while 
in the processor are called S-operators or S-ops. The combined set of these S-operators is called the S-code. 
The interpreter fetches these S-operators, determines the operation to be performed, and executes a series 
of microinstructions to achieve the desired result. The various S-machines, being interpreted by sets of 
microinstructions, enable the B 1700 to execute different language structures in the processor at the same 
time. 

Figure 2-3 shows the operational flow of a program and its S-machine, which consists of the CSM/MCP 
interface, data and associated addressing, and the S-code with its associated fetch routine. 
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Figure 2-3. Stages of Program Flow on the B 1700 and S-Machine 



S-Code 



The compiler, by scanning a program's source language statements, generates object code. Compilers formu- 
late the object code into logical divisions, called segments, for referencing by the MCP during execution. 
This can be done either at the programmer's discretion or by criteria within the compiler itself. In 
SDL, the segment dictionaries themselves are segmented (called pages). 

The object code is addressed by page number, segment number, and displacement value. The page and 
segment numbers are indices into the Code Segment Dictionary (explained below). Displacement is a 
pointer to the code relative to the base of the segment. The base address is contained in the dictionary 
descriptor. 

Code Segment Dictionary 

The compiler builds a Code Segment Dictionary for each object program that references the addresses and 
lengths of each code segment. There is an entry in the dictionary for each code segment. 

The Code Segment Dictionary provides the MCP with the address and location, whether in memory or on 
disk of each code segment used by a program. The program references its code symbolically by the page, 
segment, and displacement value. The MCP, through a field in the Run Structure Nucleus, locates the 
Code Segment Dictionary, consisting of system descriptors (see table 2-2). If the code segment desired is 
in memory, it is at the address stored in SY.CORE. If the code segment is on disk, SY.ADDRESS contains 
the disk address. The length of the code segment is given in SY.LENGTH. 
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Table 2-2. System Descriptor 



Field Name 



01 SYSTEM.DESCRIPTOR 
02 SY.MEDIA 

02 SY.LOCK 

02 SY.IN.PROCESS 



02 SY.INITIAL 



02 SY.FILE 



02 FILLER 
02 SY.TYPE 



02 SY.ADDRESS 



Type 



Bit 

Bit 
Bit 



Bit 



Bit 



Bit 
Bit 



Bit 



Length 



10 

4 



36 



Description 



Indicates whether the data being 
referenced is on disk or in memory. 

Not implemented. 

Indicates whether there is an I/O in 
process for the information repre- 
sented by this descriptor. If so, the 
field, SY.CORE, contains a refer- 
ence pointer to the I/O descriptor. 

Indicates that the field, 
SY.ADDRESS, is a disk address and 
is read-only data. If the operation is 
a write, then the MCP finds disk 
space and replaces the address in 
SY.ADDRESS. 

Indicates that this descriptor refer- 
ences a file whose user count is to 
be decremented when this descrip- 
tor is processed. 

Reserved. 

Contains a type code indicating 
the kind of data type represented 
by this descriptor. 

Type Description 

Bit 

1 Digit 

2 Character 

3 Normal descriptor 

4 Disk segment 

5 System descriptor 

6 System intrinsic 

Contains the address whether on 
disk or in memory of the informa- 
tion referenced by this descriptor. 
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Table 2-2. System Descriptor (Cont) 



Field Name 



03 FILLER 
03 SY.CORE 
02 SY. LENGTH 



Type 



Bit 



Bit 



Bit 



Length 



12 

24 
24 



Description 



Contains the port, channel, and unit 
number if this is a disk address. 

Contains the address of the data 
(memory or disk). 

Contains the number of units or 
items referenced by this descriptor 
as determined by the field, 
SY.TYPE. 



Data Dictionary 

The Data Dictionary of an object program references the address and length of the data described in the 
data definitions of the program. If the data is not segmented, the Data Dictionary has only one entry; other- 
wise, there is an entry for each data segment declared by the programmer, as is the case with COBOL. 

A program may need to process more data than is possible to have present in memory for the lifetime of 
the run. The Data Dictionary gives the programmer, or in some cases the compiler, the ability to group 
data into "blocks," some of which can be in memory or on disk at any point during the execution of the 
program. When a program references a data item and it is not present in memory, the MCP brings into 
memory the data segment of that item. This operation can require the writing out of other data segments in 
order to make memory space available. The field PROG.DYNAMIC.CORE in the PPB specifies the size of 
the memory area to be reserved for program data segments. All data segments of the program compete for 
this space. 

The first entry in the Data Dictionary describes the static memory space of the program. If the length field 
of this entry is non-zero, the MCP initializes the static memory from that entry at BO J. 

The COBOL compiler, for example, initializes WORKING STORAGE data as the program is compiled, 
storing the initialized data in the object code file on disk. When initialized data is stored on disk, the relative 
disk address of the data segment is stored in the directory entry that describes the data. The initialize bit, 
SY. INITIAL of the dictionary entry, is set to 1 at BOJ, indicating to the MCP that it must obtain a new 
disk area to contain the data segment the first time it is overlaid. 

File Parameter Block (FPB) 

Compilers build a File Parameter Block (FPB) for .each file declared in an object program. The length of 
each FPB is one disk segment. The FPB defines the file and its characteristics. At BOJ, the MCP stores both 
the File Parameter Block and the Program Parameter Block in the log area on disk (regardless of the LOG 
option setting) for reference during execution. Table 2-3 describes the FPB format. 

NOTE 

The disk space used to store the PPB and the FPBs is returned at EOJ if the LOG 
option has not been set. 
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Table 2-3. File Parameter Block 



Field Name 



01 FPB 

02 FPB.FILE.NAME 
02 FPB.NAMES 

03 FPB.PACK.ID 

03 FPB.MULTI.FILE.ID 

03 FPB.FILE.ID 
02 FPB.HDWR 
02 FPB.MODE 

03 FPB.EVEN.PARITY 

03 FPB.CODE.TYPE 



02 FPB.BUFFERS 



02 FPB.BACKUP 



02 FPB.BACKUP.OK 

02 FPB.HDWR.OK 

02 FPB.BOOLEANS 

03 FPB.FORMS 

03 FPB.OPTIONAL 
03 FPB.VARIABLE 

03 FPB.LOCK 



Type 



Bit 

Char 

Char 

Char 

Char 

Char 

Bit 

Bit 

Bit 

Bit 



Length 



Bit 



Bit 



Bit 
Bit 
Bit 

Bit 

Bit 
Bit 

Bit 



1088 

10 

30 

10 

10 

10 

6 

4 

1 



24 



1 

24 

1 

1 
1 



Description 



Contains the internal file name. 

Contains the external file name. 

Contains the disk pack-identifier. 

Contains the family-name. 

Contains the file-identifier. 

Contains the hardware-type code. 

Contains the data recording mode. 

Contains the parity: 
1, even;0, odd. 

000 = EBCDIC 

010 = BCL 

001 = ASCII 

01 1 = Binary 

Contains the number of buffers 
requested. 

Contains the type of file backup: 

00 = Either tape or disk 

01 = Tape only 

10 = Disk only 

1 1 = Either tape or disk. 

Indicates that file backup is 
permitted. 

Indicates that sending to 
hardware permitted. 

Contains control flags and data 
concerning this file. 

Indicates the output file requires 
special forms. 

Indicates this is an optional file. 

Indicates this file contains variable- 
length records. 

Indicates that this file is to be 
"locked" at termination time. 
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Table 2-3. File Parameter Block (Cont) 



Field Name 



03 FPB.COBOL 

03 FPB.EOP 

03 FPB.DEFAULT 



03 FPB. PSEUDO 
03 FPB.RMT.KEY 

03 FPB.NO.LABEL 
03 FPB.WORK.FILE 

02 FPB.RECORD.SIZE 

02 FPB.RECORD.PER.BLOCK 

02 FPB.MAX.BLOCK.SIZE 



02 FPB.ADVERB 



02 FPB.LABEL 



03 FPB.LABEL.LENGTH 



03 FPB.LABEL.ADDRESS 



02 FPB.LABEL.USE 



Type 



Bit 



Bit 



Bit 



Bit 



Bit 



Length 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



1 



24 



24 



24 



12 

48 
24 
24 

32 



Description 



Indicates an implied OPEN not 
allowed. 

Indicates the presence of an end- 
of-page routine. 

Indicates the MCP is to assign the 
block size, record size, and other 
default attributes for input disk or 
tape files according to the disk file 
header or tape label. 

Indicates that this is a pseudo 
reader file. 

Indicates key field has been 
assigned for the Network 
Definition Language (NDL) 
data communications. 

Overrides the file label and uses 
the unit name (FPB.UNIT.NAME). 

Indicates the presence of a program 
work file. (The job-number is 
included in the family-name.) 

Contains the record size 
in bits. 

Contains the number of records 
per physical record (block). 

Contains the maximum physical 
record size, in bits, for variable 
length records, and is not con- 
sulted if FPB .VARIABLE is 0. 

When this is an implied OPEN, 
this field contains the type of 
open. 

Contains the descriptor pointing 
to the user label area in memory. 

Contains the length of the label 
area in bits. 

Contains the address of the label 
area. 

Contains the segment and dis- 
placement addresses of the label 
routine. 
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Table 2-3. File Parameter Block (Cont) 



Field Name 



02 FPB.LABEL.TYPE 

02 FPB.SAVE 

02 FPB.REEL 

02 FPB.SERIAL 

02 FPB.USE. ROUTINE 

02 FPB.USE.AREA 

02 FPB.SR.STATION 
02 FPB.ACCESS 
02 FPB.AREAS 
02 FPB.EU.DRIVE 



02 FPB.ALL.AT.OPEN 
02 FPB.CYL.BOUNDARY 

02 FPB.MULTI.PACK.FILE 
02 FPB.SPECIAL.EU 

02 FPB.INC.EU 

02 FILLER 

02 FPB.REPETITIONS 



Type 



Bit 

Bit 

Bit 
Bit 
Bit 

Bit 

Bit 
Bit 
Bit 
Bit 



Length 



Bit 
Bit 

Bit 
Bit 

Bit 

Bit 
Bit 



24 

24 
24 
32 

48 



24 
4 



3 
8 



Description 



Contains the type of file label: 

= Burroughs Standard; 

1 = unlabeled. 

Contains the file retention save 
factor for magnetic tape and disk. 

Contains the reel number. 

Contains the serial number. 

Contains the segment and dis- 
placement of the first instruction 
in the USE routine. 

Contains the 24-bit length and the 
24-bit address referencing the 
work area of the USE routine. 

Contains the read station identi- 
fier for the Reader/Sorter. 

Contains the file access code: 
= serial; 1 = random. 

Contains the maximum number of 
disk areas allowed for this file. 

Contains the specified electronics 
unit (EU) or the drive number on 
which the file resides when 
FPB.INC.EU or FPB.SPECIAL.EU 
is equal to 1 . 

Allocates all areas of file at open 
time. 

Allocates the file areas on cylinder 
boundaries (disk pack or cartridge 
only). 

Enables the file to be multi-pack. 

Indicates the file resides on a 
specified EU or drive specified 
by FPB.EU.DRIVE. 

Increments the EU or drive for 
each data area. 

Reserved. 

Contains the number of copies for 
a backup file. 
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Table 2-3. File Parameter Block (Cont) 



Field Name 



02 FPB.OPEN 

02FPB.1ST.OPEN 

02 FPB.RECORD.COUNT 

02 FPB.BLOCK.COUNT 

02 FPB.NO.OPEN.AND.CLOSE 

02 FPB.CUMULATIVE 

02 FPB.ERRORS 

02 FPB.MCPDATA 

02 FPB.MCPINTERNAL 

02 FPB.BACKUP.ALREADY 

02 FPB.NEW.FORMAT 
02 FPB.PSEUDO.PDR 



Type 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 
Bit 

Bit 
Bit 



Length 



24 
24 
24 
24 
16 
24 
24 
36 



24 
24 



Description 



Contains the date of the last file 
open. 

Contains the date the file was first 
opened. 

Contains the number of records 
currently accessed. 

Contains the number of blocks 
currently accessed. 

Contains the number of opens and 
closes on this file. 

Contains the total time that the 
file was open. 

Contains the number of irrecover- 
able read/write errors. 

Contains the file header disk address 
address if FPB.MCPINTERNAL 
indicates the MCP has created a 
special internal file. 

Indicates the MCP has created an 
internal file. 

Indicates that this is already a 
backup file; therefore prohibits 
the backing up of the file again. 

Contains the literal @FFFFFF@. 

Contains the disk address of the 
pseudo reader for this file. 



File Information Block (FIB) 

A File Information Block (FIB) is an MCP table residing in memory containing information concerning a 
file. There is a FIB for every file that is processed. It is created from information in the associated File 
Parameter Block, and is used during the processing of the file. For example, the record size and blocking 
factor are two of the parameters that the FIB receives from the FPB. 

Other information maintained by the MCP in the FIB consists of the input/output mode and the current 
status of the file, as well as counters and data reference pointers. Table 2A describes the File Information 
Block format. 
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Table 2-4. File Information Block 



Field Name 



01 FILE.INFORMATION.BLOCK 
02 FIB.TYPE 

02 FIB.BOOLEANS 



03 FIB.OPEN 

03 FIB.INPUT 

03 FIB.OUTPUT 

03 FIB.PSEUDO 

03 FIB.REVERSE 

03 FIB.VARIABLE 

03 FIB.READ.LOCK 

03 FIB.DISK 

03 FIB.TAPE 

03 FIB.DISK.PACK 

03 FIB.LABELED 

03 FIB.CLUSTER 

03 FIB.BACKUP 

03 FIB.96 

03 FIB.COBOL 

03 FIB.EOT 

03 FIB.STOP.IO 

03 FIB.CYL.ALLOC 

03 FIB.MPF 

03 FIB.NEWFILE 

03 FIB.NEWAREA 

03 FIB.SPECIAL.EU 



Type 



Bit 
Bit 

Bit 



Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 



Length 



782 
6 

28 



Description 



Contains the hardware unit on which 
which the file resides. 

The following fields are used by 
the MCP, identifying the charac- 
teristics of the file and its various 
internal attributes. 
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Table 2-4. File Information Block (Cont) 



Field Name 



03 FIB.INC.EU 
03 FIB.MCPINTERNAL 
03 FIB.WAITNEWAREA 
03 FILLER 
02 FIB.RETRY.COUNT 

02 FIB.UNIT 

03 FIB.CHANNEL 

03 FILLER 

03 FIB.UNIT.NO 

02 FIB.UNIT.STATUS 

02 FIB.FPB 
02 FIB.RS 

02 FIB.RECORD 

03 FILLER 

03 FIB.RECORD.SIZE 

03 FIB.ALPHA.SIZE 

03 FIB.RECORD.ADDR 

02 FIB.CURRENT 
02 FIB.BUFFER 



Type 



Length 



Bit 


1 


Bit 


1 


Bit 


1 


Bit 


2 


Bit 


12 



Bit 

Bit 

Bit 
Bit 

Bit 

Bit 
Bit 

Bit 

Bit 
Bit 

Bit 

Bit 

Bit 

Fixed 
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12 



1 

4 

24 

36 

24 

48 

8 
16 

13 

24 

24 
24 



Description 



Contains the number of read/ 
write retries. 

Contains the physical location of 
the unit. 

Contains the port and channel of 
the unit. 

Reserved. 

Contains the hardware unit 
number. 

Contains the memory address of 
the Input/Output Available Table 
(IOAT) entry. 

Contains the FPB disk address of 
this file. 

Contains the memory address of 
the limit register of the Run 
Structure Nucleus. 

Contains a dummy (skeleton) 
descriptor created at file open and 
used for read/writes. 

Reserved. 

Contains the length of the next 
data record to be read. 

Contains the record size, in bits, 
multiplied by 8. 

Contains the address of the next 
logical record to be processed in 
the buffer. 

Contains the memory address of 
the current buffer. 

Contains the size of the buffer 
referenced in FIB.CURRENT. 



Table 2-4. File Information Block (Cont) 



Field Name 


Type 


Length 


Description 


02 FIB.BLOCK.SIZE 


Bit 


24 


Contains the maximum block size 
of the file. 


02 FIB.RECORD.COUNT 


Bit 


24 


Contains the number of logical 
read/writes on the file. 


02 FIB.BLOCK.COUNT 


Bit 


24 


Contains the number of physical 
read/writes on the file. 

NOTE 

The MCP physically read/writes in 
blocks of data, not individual 
records. This is distinguished by 
the term physical read/writes, as 
opposed to logical read /writes. 


02 FIB.HEADER 


Bit 


24 


Contains memory address of the 
file header. 


02 FIB.KEY 


Bit 


24 


Contains the current key used by 
the MCP for accessing random 
files. 


02 FIB.RECORDS.BLOCK 


Bit 


24 


Contains the number of records 
per block of the file. 


02 FIB.CLOSE.TYPE 


Bit 


12 


Contains the type of close to be 
performed. 


02 FIB.RECORDS.AREA 


Bit 


24 


Contains the number of records 
per disk area. 


02 FIB.BLOCKS.AREA 


Bit 


24 


Contains the block address. 


02 FIB.BPA.COUNT 


Bit 


24 


Contains the number of blocks 
per area. 


02 FIB.AREAS 


Fixed 


24 


Contains the number of areas for 
the file. 


02 FIB.AREA.NUMBER 


Fixed 


24 


Contains the current area number 
during serial type accessing. 


02 FIB.SEGS 


Bit 


24 


Contains the number of disk seg- 
ments per block. 


02 F1B.EOF 


Bit 


24 


Contains the reference address of 
the end-of-file (logical record). 


02 FIB.BEOF 


Bit 


24 


Contains pointer to the block 
end-of-file (physical record). 
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Table 2-4. File Information Block (Cont) 



Field Name 



02 FIB.ACCESS 



02 FIB.CHANNEL.INFO 

02 FIB.EU.DRIVE 

02 FIB.DISK.ADDRESS 

03 FIB.DISK.PC 

03 FILLER 

03 FIB.DISK.EU 

03 FIB.DISK.SG 

02 FIB.USE.ROUTINE 



02 FIB.USE.AREA 

02 FIB.MAX. RECORDS 
02 FIB.PSEUDO.RDR 



Type 



Bit 



Bit 

Bit 

Bit 

Bit 

Bit 
Bit 

Bit 

Bit 



Bit 



Bit 



Bit 



Length 



4 



24 

4 

36 



1 
4 

24 

32 



48 

24 
24 



Description 



Contains the file access type: 

= Serial 

1 =■ Random 

Contains a memory address point- 
ing to Channel table entry. 

Contains the special EU (unit) 
number or drive number. 

Contains the current disk address 
of the file. 

Contains the current port and 
channel of the file. 

Reserved. 

Contains the drive number of the 
file. 

Contains the current disk address 
of the file. 

Contains the segment and dis- 
placement of the first instruction 
in the MICR USE.ROUTINE of 
the MCP. 

Contains the length and address of 
the MICR USE.ROUTINE work 
area of the MCP. 

Contains the maximum number of 
records the file may contain. 

Contains the memory address of 
the pseudo reader for this file. 



PROGRAM OPERATION 

The object program provides the MCP with information supplied by the programmer and the compiler that 
is used to manage program execution. At BOJ, the MCP utilizes this information to provide memory space 
and to build a program run structure. 

Run Structure 

The run structure of a program consists of an area in memory, bound by a base register and limit register, a 
Run Structure Nucleus immediately following the limit register, and the Data and FIB Dictionaries. The 
program S-code (object code) can reside anywhere in memory and is not considered part of the run 
structure. 
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The area between the base and limit registers is used for program data consisting of both overlayable and 
non-overlayable data. For example, a COBOL program run structure contains the following information 
between its base and limit registers: 

a. Edit table. 

b. COP (current operand) table. 

c. Special registers. 

d. Data name monitor symbols. 

e. Work area for intermediate results. 

f. Overlayable data area. 

g. Perform stack. 

h. Alter table. 

The format of information contained between the base and limit registers is dictated by the S-machine for 
that program. Therefore, the run structure for COBOL is different than that of SDL. Figure 2-4 illustrates 
the basic format of a program run structure, and figure 2-5 shows a program run structure as it appears in 
memory. 



BASE 
REGISTE 



4- 



LIMIT \ 

REGISTER) 




DATA, 
±M VARIABLES, M 
' : : WORK AREA 



I'ri'ri'i'i'i i i j i'i i | i 



RUN 
STRUCTURE :;i 
NUCLEUS * 



:v>> DATA DICT. ^My. 

tt j i - i 'i i i rHrW r Yi : ! ! ! ': i -rf ^K ' V H-H 



FIB DICT. 




Figure 2-4. Program Run Structure 
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BASE REGISTER 



^1 



STATIC MEMORY 



LIMIT REGISTER 



DYNAMIC MEMORY 
[OPTIONAL] 

EXPANDABLE AND CONTRACTABLE 
WITH CONTROL CARD AT BOJ 




DATA DICTIONARY 
[OPTIONAL] 



FILE INFORMATION BLOCK 
(FIB DICTIONARY) 



DATA 
ONLY 



(DYNAMIC) 
CAN BE ROLLED 
OUT OF MEMORY 



(STATIC) 
f CANNOT BE ROLLED 
OUT OF MEMORY 



Figure 2-5. Program Run Structure Memory Layout 



Run Structure Nucleus 



The Run Structure Nucleus (RS.NUCLEUS) immediately follows the limit register. Each program, including 
the Master Control Program, has an RS.NUCLEUS. The RS.NUCLEUS contains information needed by the 
MCP and interpreters to execute programs. All communication between the MCP and object programs 
originates within a communicate message area in the RS.NUCLEUS of an object program. 

Run Structure Nucleus Message Pointer 

Each interpreter formulates communicate constructs that are received by the object program in its Run 
Structure Nucleus message pointer. The communicate message pointer, located immediately after the 
limit register, is 48 bits in length, and consists of the type of message plus its size and address. The location 
addressed by the communicate message pointer is a designated address within the data space of the program 
(between the base and limit registers) in which messages are sent to the MCP from the object program. The 
communicate message pointer has the following format. 
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Field Length, 
in Bits: 


RS.COMMUNICATE.MSG.PTR 


2 


6 


16 


24 


Description: 


Type of 
Communicate 
or Interrupt 


Type of 
Program- 
Dependent 
Interrupt 


Length, in Bits, 
of the 

Communicate 
Message 


Address of 
Communicate 

Message 



The first field (see RS.ITYPE in table 2-6) distinguishes between program communicates and interrupts. 
The following codes identify the type of communciate or interrupt: 

00 - Program-dependent or external interrupts. 

10 - Undefined interrupt. 

01 - Program communicate. 

1 1 - Reserved for the MCP (used to call the TERMINATE.FILE.CLEANUP procedure for the program). 

Run Structure Nucleus Reinstate Message Pointer 

Messages from the MCP to the object program are placed in the Run Structure Nucleus reinstate message 
pointer of the program. The reinstate message pointer is a 48-bit descriptor, divided into two 24-bit fields. 
It signifies whether an exception condition has or has not taken place during the communicate, and indicates 
the type of exception condition. 

The MCP sets the first 24 bits of the Run Structure Nucleus message pointer (RS.REINSTATE.MSG.PTR) 
to hexadecimal 0000 1 8 following a communicate request from an object program. The low-order 24 bits 
indicate the results of the communicate. Table 2-5 describes the exception conditions of a communicate 

message. 



Table 2-5. RS.REINSTATE.MSG.PTR Exception Conditions 



Type Code 



000000 
000001 
000002 
000003 
000004 
000005 
000006 
000007 
000008 



Result of Communicate 



No errors, valid communicate. 

I/O requested on an unopened file. 

Read requested on an output file. 

Write requested on an input file. 

Seek requested on a serial file. 

Disk record count exceeded. 

Attempt made to read an unassigned disk area. 

No available user disk. 

Disk key exceeds the End-of-File pointer for a random 
file. 
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Run Structure Nucleus Format 

Table 2-6 describes a Run Structure Nucleus format as it appears to the MCP. The RS.NUCLEUS resides in 
memory immediately following the limit register of its related program. 



Table 2-6. Run Structure Nucleus 



Field Name 


Type 


Length 


Description 


01 RS.NUCLEUS 


Bit 


2100 




02 RS.COMMUNICATE.MSG.PTR 


Bit 


48 


All communication from the pro- 
gram to the MCP takes place 
through the communicate message 
pointer. Each interpreter has access 
to the program communicate mes- 
sage pointer. 


03 RS.ITYPE 


Bit 


2 


Contains the type of message: 
communicate or interrupt. 


03 RS.INMBR 


Bit 


6 


Contains type code for a program- 
dependent interrupt. 


03 RS.ILENGTH 


Bit 


16 


Contains the length field of a 
program communicate. 


03 RS.IADDRESS 


Bit 


24 


Points to the memory address 
containing the communicate 
message. 


02 RS.COMMUNICATE.LR 


Bit 


24 


Points to the memory address of 
the limit register with which this 
program communicates. Normally, 
this is the address of the MCP limit 
register. 


02 RS.REINSTATE.MSG.PTR 


Bit 


48 


Contains a communicate message 
from the MCP to the program. 
However, if no exceptions are 
encountered, the field contains 
zero. 


02 RS.MY.BASE 


Bit 


24 


Contains the address pointing to 
the base register of this program. 


02 RS.MY.LIMIT 


Bit 


24 


Contains the address pointing to 
the limit register of this program. 


02 RS.MCP.BIT 


Bit 


1 


Indicates this is the MCP Run 
Structure Nucleus. 


02 RS.NIP 


Bit 


32 


Contains a pointer to the next 
instruction. 
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Table 2-6. Run Structure Nucleus (Cont) 



Field Name 


Type 


Length 


Description 


02 RS.SEG.DIC.PTR 


Bit 


24 


Contains a pointer to the memory 
address of the Code Segment 
Dictionary. 


02 RS.DATA.DIC 


Bit 


24 


Contains a pointer to the memory 
address of the Data Dictionary. 


02 RS.INTERP.ID 


Bit 


5 


Identifies the interpreter being 
used by referencing its entry in the 
Interpreter Dictionary. 


02 RS.INTRINSICS.LOC 


Bit 


10 


Contains the page and segment 
displacement addresses of the SDL 
virtual memory intrinsic. 


02 RS.M.MACHINE 


Bit 


768 


Contains the scratchpad (processor 
or S-machine state of the program) 
at program roll-out. 


02 RS.PRIORITY 


Bit 


24 


Contains the assigned priority of 
the program which includes the 
main priority assigned, the frac- 
tional portion, and the internally 
controlled priority assigned by 
the MCP. 


03 RS.PRIORITY.INTEGER 


Bit 


4 


Contains the assigned priority of 
the program. Default is 4. 


03 RS.INSTANT.PRIORITY 


Bit 


4 


Not used. 


03 RS.PRIORITY.FRACTION 


Bit 


16 


Not used. 


02 RS.NUMBER.FILES 


Bit 


8 


Contains the total number of 
files declared by the program. 


02 RS.BOOLEANS 


Bit 


24 


Contains a series of flags used in 
conjunction with the RS.MCP.USE 
field indicating that the program 
is waiting for operator intervention 
signified by the bits set in the 
following fields. 


03 RS.IL 


Bit 


1 


Console message 


03 RS.UL 


Bit 


1 


Console message. 


03 RS.OF 


Bit 


1 


Console message. 


03 RS.FR 


Bit 


1 


Console message. 
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Table 2-6. Run Structure Nucleus (Cont) 



Field Name 



Type 



Length 



Description 



03 RS.FM 
03 RS.OU 
03 RS.OK 
03 RS.RM 
03 FILLER 
02 RS.TYPE 

02 FILLER 
02 RS.AUX1 

02 RS.Q.IDENT 

02 RS.LAST.OVLY 

02 RS.DATA.OVERLAYS 

02 RS.LAST.LINK 

02 RS.WAIT.EVENT 



02 RS.SER.NO 

02 FILLER 

02 RS.OVLY.DISK.PTR 

02 RS.OVLY.DISK.SIZE 



Bit 
Bit 
Bit 
Bit 
Bit 
Bit 

Bit 
Bit 

Bit 

Bit 

Bit 

Bit 

Bit 



Bit 

Bit 
Bit 

Bit 



1 

1 

1 

1 

15 

16 

4 

24 

24 
24 
24 
24 

24 



24 

4 
12 

12 



Console message. 
Console message. 
Console message. 
Console message. 



Contains the disk copy address of 
this program. 



Used as a temporary storage area 
for MCP communicates. 

Identifies the queue to which the 
program belongs. 

Contains a pointer to the last 
program data overlay. 

Points to the dynamic memory 
address of the program. 

Contains a pointer to the last 
memory link within the dynamic 
memory space. 

Contains the address of the MCP 
event routine that caused the pro- 
gram to be placed in a "wait" 
condition. It usually references 
the memory address of the result 
descriptor field within the I/O 
descriptor for which the program 
is waiting an I/O completion. 

Contains the disk pack serial 
number for multiple pack files. 



Contains an index into the data 
overlay area on disk. 

Contains the total data overlay 
space available on disk. 
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Table 2-6. Run Structure Nucleus (Cont) 



Field Name 



02 RS.MIX.NMBR 
02 RS. FIB. DIC 
02 RS.TRACE 
02 RS.TRACE.FIB 

02 RS.TRACE.BITS 
02 RS.MEDIA 
02 RS.LENGTH 
02 RS.Q.LINK 

02 RS.STATUS 



Type 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Length 



24 



24 



24 



24 



Description 



24 



24 



24 



Contains the mix-index number 
of this program. 

Points to the memory address of 
the File Information Block (FIB). 

Points to the memory address of 
the trace print line. 

Points to the memory address of 
the FIB during the trace mode of 
operation. 

Contains flags denoting the type 
of trace being performed. 

Indicates whether the program is 
on disk or residing in memory. 

Contains the length of the program 
run structure. 

Points to the memory address of 
the Run Structure Nucleus of the 
next program. 

Checks the status of a program. 
Example: When MCP recognizes 
that a "WY" console message 
has been entered, RS.STATUS 
is scanned, giving condition of 
the program. Status codes and 
their descriptions are: 



Status Code 


Description 





Executing. 


1 


No file. 


2 


No user disk. 


3 


Duplicate library. 


4 


Duplicate input file. 


5 


Possible duplicate file — multi-pack files 


6 


Waiting for hardware device. 


7 


Program stopped. 
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Table 2-6. Run Structure Nucleus (Cont) 



Field Name 





Type 


Length 


Description 


Status Code 


Description 


8 


Waiting I/O complete. 


9 


Waiting a data communication message. 


10 


Waiting overlay. 


11 


Waiting keyboard input. 


12 


Hardware not ready. 


13 


Waiting operator action. 


14 


Waiting to close a file. 


15 


Waiting DS or DP. 


16 


Waiting for a continuation pack. 


17 


File not on disk. 


18 


Locked file open. 


19 


Waiting core transfer. 


20 


Program in a wait status. 


21 


No memory, waiting in communicate queue. 


22 


No memory, waiting in ready queue. 


23 


Stopped in communicate queue. 


24 


Stopped in ready queue. 


25 


Waiting in communicate queue. 


26 


Waiting in ready queue. 


29 


Terminating. 


30 


Data in ready queue. 




31 


Data 


in communicate queue. 
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Table 2-6. Run Structure Nucleus (Cont) 



Field Name 



Type 



Length 



Description 



02 RSJOB.NUMBER 
02 RS.DISK.USE 
02 RS.TIME 
02 RS.PROG.PTR 
02 RS.PAUSE 

02 RS.DONT.REENTER 
02 RS.SD.PTR.FLAG 



02 RS.LINKS 
02 RS.ABORT 
02 RS.DISK 

02 RS.RECAUSE 

02 RS.IN.MOTION 
02 RS.HIERARCHY 

02 RS.APPARATION 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 
Bit 
Bit 

Bit 

Bit 
Bit 

Bit 



24 
20 
20 
36 

24 

1 



1 

1 

36 

1 



Contains the job number of this 
program. 

Contains the total number of disk 
accesses for program overlays. 

Contains the total processor 
elapsed time for this program. 

Contains the disk address of the 
code file. 

Contains the time, in tenths of a 
second, that this program is not 
being processed. 

Indicates that the program is not 
allowed to share its Code Segment 
Dictionary. 

Indicates that the field 
RS.SEG.DIC.PTR. points either to 
the memory address of the Code 
Segment Dictionary or to the 
memory address of the dictionary 
container. 

Indicates that memory links are 
present. 

Indicates that the program is 
ready to be discontinued. 

Contains an address pointing 
to the location of the code when 
rolled-out of memory. 

Ensures that when the program is 
returned to memory for processing 
that it enters the CAUSE routine 
of the MCP. 

Indicates that the program is in the 
process of being rolled-out or 
rolled-in. 

Contains the nesting level of the 
program initiated by a program 
"CALL". There is a maximum 
of 255. 

Indicates that this program, while 
executing, referenced another pro- 
gram and is now waiting for the 
"called" program to terminate. 
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Table 2-6. Run Structure Nucleus (Cont) 



Field Name 



02 RS.SIZECHANGE 



02 RS.WAIT.MIX 



02 RS.WAIT.IS.JN 

02 RS.OUT.MEM 

02 RS.OUT.ABS 

02.RS.FREEZE 

02 RS.PSEUDO.READER 

02 FILLER 

02 RX.OVLY.DESC 

02 RS.MCP.USE 



02 RS.FPB 

03 FILLER 

03 RS.UNIT.INDEX 

02 RS.OVLY.DISK.BASE 
02 RS.LOG.PTR 



Type 



Bit 



Bit 



Bit 



Bit 

Bit 
Bit 
Bit 

Bit 
Bit 

Bit 



Length 



Bit 

Bit 
Bit 

Bit 
Bit 



24 

24 
248 

1 



36 

12 
24 

36 
36 



Description 



Indicates that the scratchpad area 
is being programmatically modified 
in size. 

Indicates that the field, RS.PAUSE, 
contains the mix-index of the pro- 
gram for which this program is 
waiting completion. 

Indicates that the field, RS.PAUSE, 
contains the job-number of the pro- 
gram for which this program is 
waiting completion. 

Indicates that the program has 
stopped executing and is waiting 
memory space to restart. 

Indicates that the program has been 
stopped by the operator. 

Indicates that the program cannot 
be rolled-out of memory. 

Contains a pointer to the memory 
address of the current pseudo 
reader. 



Contains the I/O descriptor used 
for code and data overlays. 

Indicates that the event referenced 
by the field, RS.BOOLEANS, must 
occur before the program can con- 
tinue processing. 

Points to the disk address of the 
file being opened. 



Contains an index referencing an 
entry in the Input/Output Available 
Table (IOAT). 

Points to the base address of the 
program data overlays on disk. 

Points to the disk address of the 
current PPB and FPBs. 
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Object Program In Memory at BO J 

Figure 2-6 contains a simplified program run structure consisting of a programs various pointers and their 
relationship to each other. 
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SECTION 3 

INPUT/OUTPUT 



INTRODUCTION 



Input/Output (I/O) is the transfer of data between peripherals and the central processing unit. The I/O 
components of the B 1 700, referred to as the I/O subsystem, consist of the Central Service Module (CSM), 
MCP, interpreters, and the object programs. Each peripheral has its own I/O channel which simultaneously 
inputs/outputs data with other channels. 

The MCP supports the I/O subsystem by performing the following functions: 

a. Manages all peripherals on the system. 

b. Initiates I/O for all programs. 

c. Reinstates the program after I/O. 

d. Builds a log of I/O activities. 

e. Handles automatic error recovery procedures. 

The programmer, by generating I/O source statements such as read and write causes the compiler to 
formulate object code instructions containing the specific information needed to perform the I/O. Once 
the object program is in memory and is being executed, the interpreter communicates I/O results received 
from the CSM to the MCP through the communicate message pointer contained in the program Run 
Structure Nucleus. 

The MCP prepares the data needed by the CSM to initiate the I/O. By constructing a description of the 
I/O and providing a buffer for the I/O data, the MCP passes the I/O information to the CSM. The CSM 
attempts to service the I/O while the MCP continues processing. Once data transfer is completed, control 
is eventually returned to the object program for the next instruction. 

During the interpreter fetch loop, an interrogation is made for any I/O needing service. If I/O servicing 
is required, the CSM determines what I/O device or devices need servicing and performs the required 
data transfers. 

I/O DESCRIPTOR 

I/O descriptors are constructed by the MCP upon receiving an I/O request issued by an object program. 
An I/O descriptor contains the control information needed to achieve the I/O operation. I/O descrip- 
tors with multiple buffers are chained together, with each buffer having an associated descriptor. 

After initiating the first I/O descriptor in the I/O buffer chain, the CSM examines the I/O result which is 
located in the first 24 bits of the I/O descriptor. When the result of that I/O is received, the CSM checks the 
I/O status of the next I/O descriptor and attempts to initiate that I/O request. While the CSM is linking 
between I/O descriptors, processing continues. 

NOTE 

If an error condition exists on any I/O operation, that particular I/O chain is 
broken and the MCP is notified. 

The differences concerning the information contained within I/O descriptors are due to both the hardware 
device selected and the nature of the I/O. 
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I/O Status 

After an I/O operation is complete and the ending buffer address of the data is stored, the status of the 
I/O is placed in the I/O result field in the I/O descriptor. The result status is marked either complete or 
complete with exceptions. 

Table 3-1 describes the format of an I/O descriptor. For additional information concerning I/O 
descriptors refer to the B 1700 System R eference Manual, Form No. 10571 55. 



Table 3-1. I/O Descriptor 



Field Name 



01 IO.DESCRIPTOR 
02 IO.RESULT 

03 IO.COMPLETE 
03 IO.EXCEPTION 



Type 



Bit 



Bit 



Bit 



Bit 



Length 



248 



24 



Description 



Contains the I/O result status of 
an attempted I/O operation. 

Used by the I/O control, indicating 
a successful I/O has been com- 
pleted. 

Indicates whether an exception 
condition has been issued by the 
I/O control. The IO.EXCEPTION 
and the IO.COMPLETE fields 
enable the MCP to monitor the 
status of the I/O at any time. The 
settings of both fields that indicate 
I/O status are: 



IO.COMPLETE 
Field 





IO.EXCEPTION 
Field 





03 FILLER 
03 IO.DEST 



Bit 



Bit 



10 



Description 

Indicates that the I/O 
descriptor is not in use. 
The MCP writes zeroes 
to this area. 

Indicates that the I/O 
request is in process. 

Indicates that the I/O 
is complete with no 
exceptions. 

Indicates that the I/O 
is complete with 
exceptions. 



Contains the port identification 
for this I/O descriptor. 
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Table 3-1 . I/O Descriptor (Cont) 



Field Name 



03 10. INTERRUPT 



03 10.HI.INT 



02 10. LINK 



Type 



Bit 



Bit 



Bit 



Length 



24 



02 IO.OP 



02 IO.BEGIN 



02 IO.END 

02 10.DISK.ADDRESS 



Bit 



Bit 



Bit 



Bit 



24 



24 

24 
24 



The entries above this point are common for all I/O descriptors. 



02 IO.MCP.IO 



02 10. FIB 



Bit 



Bit 



24 



24 



Description 



Causes the CSM to store an 
interrupt message in the INTER- 
RUPT queue when the I/O 
is complete. 

Indicates that the MCP is not 
requesting a high-priority inter- 
rupt at operation complete 
(MICR Reader/Sorter). 

Contains an address pointing 
to the next I/O descriptor in the 
chain. After storing the I/O 
status information, and after re- 
turning any requested interrupt 
message, the CSM (in the absence 
of an error condition) fetches the 
address contained in 10. LINK 
referencing the next I/O 
descriptor. 

Contains the type of the I/O 
operation. It consists of the 
operation code, any variants, 
and the unit number of the I/O. 

Contains an address pointing 
to the beginning data location 
in the I/O buffer. 

Contains an address pointing to 
the end of the I/O buffer. 

Contains the beginning disk seg- 
ment address of the I/O operation. 
When the I/O is magnetic tape, 
IO.DISK.ADDRESS contains 
the address of the tape unit Lock 
descriptor. 



Indicates how the MCP is to 
handle an I/O request when 
control is regained from an 
interrupt situation. 

Addresses the File Information 
Block (FIB) of the file request- 
ing the I/O. 
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Table 3-1. I/O Descriptor (Cont) 



Field Name 


Type 


Length 


Description 


02 IO.FIB.LINK 


Bit 


24 


Addresses the next I/O descriptor 
in this I/O chain. 


02 IO.BACK.LINK 


Bit 


24 


Addresses the previous I/O 
descriptor in the I/O chain 


02 IO.PORT.CHAN 


Bit 


7 


Contains the physical hardware 
location (port and channel) for 
the I/O request. 


03 IO.PORT 


Bit 


3 




03 IO. CHANNEL 


Bit 


4 


- - - 



MAGNETIC TAPE I/O SUBSYSTEM 

Because of the serial nature in processing magnetic tape, there is only one chain of I/O descriptors for 
the entire magnetic tape I/O subsystem. Similar to disk I/O operation, the I/O descriptors are executed 
logical sequence. To help ensure the serial processing of magnetic tape, a "lock" type descriptor is used 
for control. 



in 



Lock Descriptor 

Table 3-2 describes the Lock Descriptor format. 



Table 3-2. Lock Descriptor 



Field Name 


Type 


Length 


01 LOCK.DESCRIPTOR 


Bit 


144 


02 LOCK.RESULT 


Bit 


24 


02 LOCK.LINK 


Bit 


24 


02 LOCK .OP 


Bit 


24 


02 LOCK.LINK.FIRST 


Bit 


24 


02 LOCK.LINK.NEXT 


Bit 


24 


02 LOCK.LINK.PREVIOUS 


Bit 


24 
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There is one lock descriptor in the magnetic tape I/O subsystem chain for each tape unit. All I/O descrip- 
tors for a particular unit are linked, directly or indirectly, to the lock descriptor for that unit. The LOCK. 
LINK field of the lock descriptor always contains either the memory address of the lock descriptor for 
the next unit in the magnetic tape I/O subsystem, or the address of a "pause" type descriptor. There is one 
"pause" descriptor for the entire magnetic tape I/O subsystem. The LOCK.LINK.FIRST field of the lock 
descriptor always contains the memory address of the first physical record for the unit. This field is ini- 
tialized by the MCP when the file is opened. LOCK.LINK.NEXT contains the memory address of the next 
logical record to be executed on the unit. 

NOTE 

The physical record is the first record in a data buffer. The logical record is 
the record within a buffer that is currently being processed. 

LOCK.LINK.NEXT is initialized by the MCP, but is maintained by the CSM. 

The function of a lock descriptor can be explained using the following example where two programs, A 
and B, are using one magnetic tape control with three available units. The complexity of the magnetic 
tape I/O subsystem, however, does not increase, regardless of the number of controls or units. 

Example : 

Figure 3-1 demonstrates program A and program B utilizing two units under one control, and the 
I/O descriptor chain that is manufactured by the MCP for the I/O operations. 

In this example, Program A opens unit 1 as input and has three buffers. The MCP obtains 
memory space and links the three I/O descriptors to the lock descriptor for unit 1 . The three 
I/O descriptors are denoted in figure 3-1 as READ-1 , READ-2, and READ-3. 

Program B opens unit 2 as output and has two assigned buffers. The MCP obtains memory 
space and links the two I/O descriptors to the lock descriptor for unit 2. The two I/O descriptors 
are denoted in figure 3-1 as WRITE-1 and WRITE-2. 

Unit 3, not currently being used, has the mandatory lock descriptor present. 

At the time of the open by program A, the magnetic tape control is idling (pause type descrip- 
tor) When the pause is recognized as complete (result of the open), the CSM exits the pause 
descriptor and reads the lock descriptor for unit 1 . The I/O complete bit in the result descriptor 
field of a lock descriptor is always 0, causing the CSM to always read the lock descriptor operation 
code. 

The CSM recognizing a lock descriptor, swaps 01 into the first two bits of the result descriptor 
field, LOCK.RESULT, and examines the two bits that were received. If they are 01 , indicating I/O 
in progress, the CSM exits immediately to the next lock descriptor in the chain. This prevents 
two controls from attempting to execute descriptors for the same unit at the same time. In this 
example, however, there is only one control but this technique of checking lock descriptors 
provides a fast and simple method for the MCP to lock out an entire unit. 
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Figure 3-1. Magnetic Tape I/O Subsystem Descriptor 
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CHANNEL TABLE 

The MCP Value stack (refer to B 1700 System Reference Manual , Form No. 1 057155) contains a set of 
eight contiguous 24-bit fields (0-7). Each field contains either a zero or the Channel table memory address 
corresponding to that port. 

If the Value stack field contains any dispatches directed to that port (e.g., a message from the MCP notify- 
ing the CSM that there is an I/O for that port and channel), the dispatch routine in the CSM reports a 
missing device condition to the MCP. If the field contains a memory address, the I/O is attempted. Each 
Channel table is an area in memory containing 16 entries, each 48 bits in length. Table 3-3 describes 
the Channel table. 



Table 3-3. Channel Table 



Field Name 



01 CHANNEL.TABLE 
02 CHANNEL.BUSY 

02 CHANNEL.PENDING 

02 CHANNEL.EXCEPT10N 



02 CHANNEL.PAUSE 



02 CHANNEL.OVERRIDE 



Type 



Bit 



Bit 



Bit 



Length 



Bit 



02 CHANNEL.EXCHANGE 



02 CHANNEL.OLD.MODE 



Bit 



Bit 



Bit 



Description 



Indicates the I/O device has 
processing activity. 

Indicates the I/O is waiting 
execution. 

Indicates the device is idle be- 
cause of an exception condition. 
All dispatches to this device are 
ignored as long as this bit is 1 . 

Indicates whether there is to be 
an automatic dispatch at Timer 
interrupt using the reference 
address stored in the field, 
CHANNEL.REF.ADDR. 

Overrides bits 0,1, and 2 of the 
table and sends a dispatch to the 
control regardless of the status or 
condition of the I/O. Bits 0, 1 , 
and 2 of the table are set to at 
the time of a dispatch. 

Indicates whether this entry is 
or is not part of an exchange, or 
is or is not the last entry in the 
exchange. 

Indicates whether the device is 
to be processed by "enhanced" 
I/O or the previous subsystem. 



3-7 



Table 3-3. Channel Table (Cont) 



Field Name 



Type 



Length 



Description 



NOTE 

"Enhanced" I/O is a temporary term used to distinguish between the newer version 
of the I/O subsystem and the previous or older I/O subsystem to which there has 
been significant programmatic changes. 



02 CHANNEL. INTEGRITY 



02 CHANNEL.LOCK.CNTR 



02 CHANNEL.TYPE 



02 CHANNEL.LAST 



02 CHANNEL.EXCHANGE.PC 

03 CHANNEL.EXCHANGE.P 
03 CHANNEL.EXCHANGE.C 
02 CHANNEL.REF.ADDR 



Bit 



Bit 



Bit 



Bit 



Bit 

Bit 
Bit 
Bit 



3 

4 

24 



Indicates the MCP has determined 
what kind of a device is on the 
channel. 

Contains counters for the lock 
descriptor chains. 

Contains a type code used for 
the MCP Dump Analyzer program. 

Type = serial device 
Type 1 = disk 
Type 2 = tape 
Type 3 = cassette 
Type4 = MFCU : 

Indicates that this device is the 
last entry in the Channel table 
for this port. This aids the CSM 
at Timer interrupt for sparsely 
populated channel tables. 

Stores the "linked" port and 
channels. 

Contains the port. 

Contains the channel. 

Contains the beginning reference 
address when the control is acti- 
vated after a Timer interrupt. 
(Refer to CHANNEL.PAUSE) 



Channel Table Operation 

The first two bits of a Channel table entry (CHANNEL.BUSY and CHANNEL.PENDING) are used 
together as described below. 

a. When the CSM is at a point where it is idle, it swaps 01 into the first two bits of the Channel 
table. If a 00, 01 , or 10 is received, the device goes idle (waits for I/O to complete) and 
writes a 00. If it receives a 1 1, it writes a 10 and continues executing. 

b. When the CSM initiates a device from a dispatch, it swaps in a 1 1 . If a 00 is received, it 
dispatches the I/O; if it receives a 10 or 1 1, it exits, doing nothing; if it receives a 01 , it 
continues to read the first two bits until it receives a 00. 
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The CHANNEL.EXCEPTION field in the Channel table is used by those devices that go idle on an I/O 
exception condition. The MCP resets this bit before redispatching the I/O descriptor that caused the 
exception. (Tape and disk devices do not go idle on an exception condition.) 

If the MCP forces a dispatch on a "busy" control (e.g., console printer in a test and wait condition), it 
sets the CHANNEL.OVERRIDE bit in the Channel table prior to the dispatch. 

The result status field in the I/O descriptor is initialized by the MCP prior to a dispatch, and is updated by 
the I/O subsystem while the I/O operation is in progress. The result status field is then replaced by the 
result descriptor field when the I/O is complete. 

Listed below are the result status field bit assignments prior to an I/O completion (bits are indexed from 
left to right, to 23): 

Bit Description 

Always contains a 0. 

1 Set to 1 by the CSM during processing. 

2 Reserved for expansion of the I/O subsystem. 

3 Reserved for expansion of the I/O subsystem. 

4 Reserved for expansion of the I/O subsystem. 

5 Indicates a locked state. 

6 Indicates a disk device (uses explicit pause and link 
on exception or I/O complete). 

7 Indicates a tape device (Lock descriptor mechanism). 

8 Indicates reader/sorter. 

9 Indicates data communications. 

10 Reserved. 

1 1 Indicates this is an exchange. 

12-14 Contains the destination port. 

1 5 Indicates an interrupt request. 

1 6 Indicates an interrupt request (high-priority). 

17-19 Contains the port to which to return the interrupt 

(usually 0, indicating the processor). 

20-23 Contains the channel number of the device. 

Except when the CHANNEL.OLD.MODE field in the Channel table indicates the "old" I/O mode, a 
dispatch is directed by the MCP to the CSM for each result status field of an I/O descriptor that is 
initialized. If the result status field is not set to 1 during the I/O operation, bits and 1 are set to 
immediately prior to a dispatch. 

After the dispatch and prior to I/O complete, the only two bits the MCP can modify in the result status 
field are bits 15 and 16. The modification is done as a replacement operation and is done only once. 
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For those devices that are processed by the "old" I/O mode, such as Data Comm and the Reader/Sorter, 
the CHANNEL.OVERRIDE field in the channel table is set prior to initiating the dispatch. 

PORTS 

In the Value stack of the MCP, there is a set of eight contiguous 24-bit fields that correspond to ports 
through 7 respectively. Each field contains either a or the memory address of the Channel table that 
corresponds to that port. 

When a port field contains zeros, indicating that there is not a channel associated with the port, dispatches 
directed to the referenced port cause the dispatch routine in the CSM to wait in anticipation of a 
"missing device condition." A "missing device condition" in any other situation halts the system. 

I/O devices connected to the processor on port are assumed to be on port 7. 

EXCHANGES 

Exchanges are logical switching matrices interfacing a control or controls to one ore more electronic units 
that direct the flow of information to and from those units. For example: Suppose there are number port 
and channel combinations corresponding to n working controls for an exchange. One of those combina- 
tions according to the I/O descriptor is selected as the primary port and channel for that exchange. The 
primary port and channel is the only port and channel combination allowed in the result status field 
of any I/O descriptor for that exchange. 

The Channel table entry corresponding to the primary port and channel for the exchange sets the 
CHANNEL.EXCHANGE bit. The port and channel bits in the Channel table then point to the next 
port and channel for the same exchange. If the new port and channel is the last port and channel combi- 
nation for the exchange, then CHANNEL.EXCHANGE in the Channel table is not set, and its port 
and channel field in the Channel table points back to the primary port and channel. Otherwise, CHAN- 
NEL.EXCHANGE is set and the port-channel field points to the next port and channel for that exchange. 

Dispatches are sent only to the primary port and channel. The CSM searches for an idle control on an 
exchange when attempting to service a dispatch. 

Any dispatches directed to a device whose Channel table entry has CHANNEL.PAUSE set will cause the 
CSM to use' the address in the CHANNEL.REF.ADDR as the dispatch address, as opposed to the address 
sent with the dispatch. This action occurs because a magnetic tape I/O subsystem must be initiated 
through lock descriptors. 

INPUT/OUTPUT ASSIGNMENT TABLE (IOAT) 

The Input/Output Assignment Table (IOAT) is a memory resident table, constructed, and used exclusively 
by the MCP. The purpose of the IOAT is to retain information concerning the status and availability of all 
peripherals on the system. 

Table 3-4 describes an IOAT entry format. 

Table 3A. Input/Output Assignment Table 



Field Name 


Type 


Length 


Description 


01 IOAT 


Bit 


492 




02 UNIT.INITIAL 


Bit 


66 


Contains the physical location 
of this peripheral. 


03 UNIT.HDWR 


Bit 


6 


Contains the hardware 
identification number. 
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Table 3-4. Input/Output Assignment Table (Cont) 



Field Name 



03 UNIT.PCD 

04 UNIT.PORT.CHANNEL 
05 UNIT.PORT 
05 UNIT.CHANNEL 

04 FILLER 

04 UNIT.UNIT 

03 UNIT.NAME 
02 UNIT.LABEL.ADDRESS 

03 FILLER 

03 UNIT.PACK.INFO 

02 UNIT.RS 

02 UNIT.FLAGS 



Type 



03 UNIT.AVAILABLE 

03 UNIT.AVAILABLE.INPUT 

03 UNIT.AVAILABLE.OUTPUT 

03 UNIT.WAIT.FOR.NOT.READY 

03 UNIT.TEST.AND.WAIT 

03 UNIT.SAVED 

03 UNIT.REWINDING 

03 UNIT.EOF.SENSED 



Bit 

Bit 
Bit 
Bit 
Bit 
Bit 

Char 

Bit 

Bit 
Bit 

Bit 
Bit 



Length 



Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 



12 

7 
3 
4 
1 
4 



Description 



36 



24 
24 

24 
24 



Contains the port and channel 
of the peripheral. 

Contains the port and channel. 

Contains the port. 

Contains the channel. 

Reserved. 

Contains the unit number of 
this port and channel. 

Contains the unit mnemonic 
identification. 

Points to the unit label location. 
When the entry represents a 
disk unit, it points to the Disk 
Pack Information table. 



Contains @FFFFFF@ if this 
entry is for a system pack. 

Contains the address pointing to 
the limit register of the program 
to which this entry is assigned. 

A set of indicators that continu- 
ally monitor the operating 
condition of the peripheral 
represented by this entry in the 
IOAT. The following fields are 
used for the monitoring 
purpose. 
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Table 3-4. Input/Output Assignment Table (Cont) 



Field Name 



Type 



Leng 



Description 



03 UNIT.LOCKED 

03 UNIT.LABEL.SENSED 

03 UNIT.PRINT.BACKUP 

03 UNIT.PURGE 

03 UNIT.LOCK.AT.TERM 

03 UNIT.TO.BE.SAVED 

03 UNIT.FLUSH 

03 UNIT.TAPEF 

03 UNIT.DISKF 

03 UNIT.STOPPED 

03 UNIT.TRANSLATE 

03 UNIT.CTRL.CARD.USING 

03 UNIT.REMOTE.JOB 

03 UNIT.CLOSED 

03 UNIT.FILLER 
02 UNIT.STATUS 

02 UNIT.JOB.NUMBER 
02 UNIT.FIB.ADDRESS 

02 UNIT.LABEL.TYPE 



02 FILLER 

02 UNIT.TEST.DESC 



Bit 
Bit 
Bit 
Bit 
Bit 
Bit 
Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 
Bit 

Bit 
Bit 

Bit 



Bit 
Bit 



2 
15 

24 
24 



24 

248 



Indicates the unit is to read to 
End-of-File. (Example: Card 
Reader.) 



Contains the first 1 5 bits of 
the I/O result descriptor 
field. 

Contains the job number 
assigned to this entry. 

Points to the File Information 
Block (FIB) when this entry 
is associated with a file. 

Contains the label type code : 

00 = Omitted 

01 = Burroughs standard 

02 = ANSI 

03 = Installation 

Reserved. 

Contains the test I/O descriptor 
used to interrogate the status of 
the peripheral (e.g., Is it ready? 
Is it busy?). 
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SECTION 4 

MCP DISK STRUCTURES 



INTRODUCTION 

A significant aspect of the B 1 700 design is disk management, which is the responsibility of the MCP. 
There are four areas of disk management which the MCP controls: 

a. Directory maintenance. 

b. Disk allocation. 

c. File assignment. 

d. Record addressing. 

A disk pack or cartridge must be initialized by the program Disk Initializer before it can be used on the 
system. At the time of initialization, the user assigns a serial number, a disk identifier, the type of pack or 
cartridge (system, unrestricted, restricted, or interchange), the date of initialization, and comments if 
desired. 

Head-per- track disk is pre-initialized; no user initialization is necessary. 

The basic function of initializing a disk is to assign an address for each segment. This address is the means 
by which the MCP accesses disk segments. After the assigning of the addresses, the Disk Initializer generates 
the following: a Master Available Table, skeletal Disk Directory, Working Available Table, Temporary 
Available Table, and a label identifying the pack or cartridge. 

DISK PACK/CARTRIDGE CHARACTERISTICS 

The disk pack and disk cartridge are data storage devices that can be moved on or off line. Both the 
disk pack and disk cartridge are divided into segments (sectors), tracks, and cylinders which organize 
the storage of data and identify its locations. Figures 4-1 and 4-2 illustrate the basic characteristics of 
the read/write mechanism and the recording surfaces. 



RETRACTABLE ARM 



CYLINDER (UPPER TRACK) 



READ/WRITE HEADS 




CYLINDER (LOWER TRACK) 
-LOWER DISK SURFACE 

Figure 4-1 . Disk Read/Write Mechanism 
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Figure 4-2. Disk Recording Surface 
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The Data storage format consists of a circular track, divided into sectors called segments with each 
segment containing 1 80 bytes of storage, as shown in figure 4-2. A disk platter has two surfaces, each 
capable of storing data. All tracks that lie in the same vertical plane constitute a cylinder. 

DISK FILE IDENTIFIERS 

The B 1 700 programmer addresses disk files by their symbolic names. The physical disk address of a 
file is the responsibility of the MCP and not the user program. The file-identifier has three possible 
components: 

a. Disk pack/cartridge-identifier. 

b. Main directory identifier (family-name). 

c. Sub-directory identifier (file-identifier). 

For a detailed description of disk file names and their usage concerning system operation, refer to the 
B 1700 System Software Operational Guide , Form No. 1068731. 

DISK DIRECTORIES 

Files are either temporary or permanent. A temporary file is a disk file that is created by programmatic 
action and whose existence is only in relationship to the creating program. It becomes non-existent 
when the creating program terminates or when the file is closed without a lock. A permanent file is one 
that can be accessed at any time by any program and remains in the Disk Directory until removed. 

At COLDSTART, the MCP reserves 16 contiguous segments of systems disk for the initial Disk Direc- 
tory; each segment contains 1 1 entries, giving a possible total of 176 directory entries. If more space 
is required, the MCP increases the Disk Directory size by one segment for each additional 1 1 entries. 
Figure 4-3 shows a simplified Disk Directory with a main directory /sub-directory file entry. Table 4-1 
describes the Disk Directory format. 
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Figure 4-3. Disk Directory Filing Technique 
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Table 4-1 . Disk Directory 



Field Name 


Type 


Length 


Description 


01 DIRECTORY 


Bit 


1440 




02 DISK.SUCCESSOR 


Bit 


36 


Contains a disk address that 
points to the next directory 
entry, and is referred to as the 
forward link. If this entry con- 
tains zero, it is the last entry of 
the directory. 


02 DISK.PREDECESSOR 


Bit 


36 


Contains a disk address that 
points to the previous directory 
entry, and is referred to the back- 
ward link. If this entry contains 
zero, it is the first entry of the 
directory. 


02 DISK.SELF 


Bit 


36 


Contains the disk address of this 
entry in the directory. 


02 FILLER 


Bit 


12 




02 DISK.NAME 


Char 


10 


Contains the family-name of this, 
entry. 


02 DISK.ADDRESS 


Bit 


36 


Points to the file header of this 
entry ; if there is a sub-directory 
entry, it points to the related 
sub-directory. 


02 D1SK.FILE.TYPE 


Bit 


4 


Describes the file access type 
referenced by this directory 
entry, as follows: 

Type Description 

1 Log, Elog 

2 Sub-directory 

3 Control deck 

4 Print back-up 

5 Punch back-up 

6 Dump file 

7 Interpreter 

8 Code file 

9 Data file 

10 Undefined 

1 1 Variable data 


02 FILLER 


Bit 


1200 


Contains space for 1 available 
entries. 
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Main Directories 

The MCP enters a file into the main directory by a technique whereby the family-name of the file is 
randomized into a single reference digit of to 15. This digit is used as an index into the directory where 
all files having the same index reside. This method reduces directory search time by a factor of 16. If, 
while scanning the directory, the MCP finds the dictionary is full, it expands that directory by one segment, 
updating the field DISK. SUCCESSOR to point to the new segment. If the MCP is simply searching for 
a file, the family-names are compared until the file is located. 

Sub-Directories 

Files that are identified by a first or primary name and also by a second name have sub-directory entries. 
When a file has an identifier such as A/B or A/C, the main directory field, DISK. ADDRESS, does not refer- 
ence the location of the file but contains the address of its related sub-directory. The DISK.ADDRESS 
field in the sub-directory then points to the file header. The DISK.FILE.TYPE field in the main directory 
contains a 2 when there is a sub-directory associated with the file. The format of main directories and 
sub-directories is the same. Figure 4-4 illustrates an example of disk directory entries. 



fwd bkwd TU1 _ 

LINK LINK '"'» 
AODR ADDR ADDR 



FILE 
NAME 



DISK FILE 
ADDR TYPE 



FILE 
NAME 



DISK FILE 
ADDR TYPE 




I 



9A5 



1008 



■¥-*** 






1 ST ENTRY 



2ND ENTRY 



y ■ 

it 



6F3 



98FB 



W'iWi 



i'l't'i't'i'ii'ivi I 



_7\Z 



1 ST ENTRY 



END ENTRY 



200 






4FE 



933B 



1ST ENTRY 



2ND ENTRY 



NOTE: 

SINCE FILE NAME A IS FILE TYPE 2, THE DISK ADDRESS 
FIELD (9A5) POINTS TO THE ADDRESS OF ITS RELATED 
SUB- DIRECTORY WHICH POINTS TO THE FILE HEADER. 



Figure 4-4. Disk Directory Entries 
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DISK FILE HEADER 

The disk file header contains the physical characteristics of the disk file and the absolute addresses of each 
area allocated to the file. Table 4-2 describes the format of a disk file header table entry. 

NOTE 

Disk file headers are outside a program run structure. Therefore a pro- 
gram memory dump does not reflect the disk file headers. The disk file 
headers can be obtained by dumping total memory and executing 
MCPII/ANALYZER. 



Table 4-2. Disk File Header 



Field Name 



Type 



Length 



Description 



01 DISK.FILE.HEADER 
02 DFH.CORE.ADDR 

02 DFH.SELF 

02 DFH.NO.USERS 

02 DFH.USERS.OPEN.OUT 

02 DFH.OPEN.TYPE 



02 DFH.FILE.TYPE 
02 DFH.PERMANENT 



02 DFH.HDR.SIZE 
02DFH.RECORD.SIZE 
02 DFH.RECDS.BLOCK 



Bit 
Bit 

Bit 
Bit 

Bit 

Bit 



Bit 

Bit 



Bit 
Bit 
Bit 



1440 

24 

36 



4 
4 



24 
24 
24 



Points to the memory address of 
the disk file header when the 
header is in memory. 

Contains the disk address of this 
disk file header. 

Contains the number of programs 
that are referencing the file but 
not necessarily accessing the file. 

Contains a counter signifying the 
number of programs that are cur- 
rently accessing the file. 

Contains the type of file open: 

1000 = Lockout 
0010 = Input 
0001 = Output 
0100 = Lock 

Contains the type of file. 

Contains the file status. 

0000 = Temporary File 

0001 = Permanent File 
1111= System File 

Contains the disk file header size. 

Contains the record size. 

Contains the number of records 
per block (blocking factor). 
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Table 4-2. Disk File Header (Cont) 



Field Name 



Type 



Length 



Description 



02 DFH.BLOCKS.AREA 



02 DFH.SEGS.AREA 



02 DFH.AREA.RQST 



02 DFH.AREA.CTR 



02 DFH.EOF.POINTER 



02 DFH.BPS.NO 

02 DFH.BLOCK.COUNT 

02 DFH.MPF 

02 DFH.DBM.LINK 

02 DFH.DBM.DFH.NO 

02 DFH.USER.INFO 
02 DFH.SAVE.FACTOR 

02 DFH.CREATION.DATE 
02 DFH.ACCESS.DATE 

02 DFH.MPF.ADDR 
02 FILLER 



Bit 



Bit 



Bit 



Bit 



Bit 



Bit 
Bit 
Bit 
Bit 
Bit 

Bit 
Bit 

Bit 
Bit 

Bit 
Bit 



24 



24 



12 



12 



24 



24 



24 



24 
24 

24 
12 

16 
16 

36 
60 



Contains the number of blocks 
per area. 

Contains the number of segments 
per area. 

Contains the number of areas 
requested for the file. 

Contains the number of areas 
used. 

Input File: Contains the End- 
of-File address. 

Output File: Contains the num- 
ber of records output. 

Random File: Contains the max- 
imum key value. 

Contains the base pack serial 
numbers of a multiple pack file. 

Contains the number of proc- 
essed blocks. 

Indicates this is a multiple pack 
file. 

Points to the next file header 
(data management). 

Contains a reference number used 
as the internal identifier for file 
headers using data management. 

Not implemented. 

Contains the number of days a 
file is to be retained beyond its 
last access date. 

Contains the date of file creation. 

Contains the date that the file 
was last opened. 

Contains the disk address of 
the Multiple Pack Information 
table. 

Reserved. 
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Table 4-2. Disk File Header (Cont) 



Field Name 



02 DFH.AREA.ADDRESS 



03 DFH.UNIT 

04 DFH.PORT 
04 DFH.CHAN 

04 DFH.SER.NO.FLAG 
04 DFH.EU 



Type 



Bit 



Bit 

Bit 
Bit 

Bit 



Bit 



Length 



36 



12 

3 
4 



03 DFH.ADDR 



Bit 



24 



Description 



Contains the beginning disk add- 
ress of the first data location. 
There is a maximum of 105 
areas available. 

Contains the port, channel, flag 
indicator, and the electronics 
unit of this disk unit. 

Contains the port identification. 

Contains the channel identifi- 
cation. 

Denotes whether the DFH.ADDR 
is the actual data address or the 
pack serial number of a multiple 
pack file. 

If this file is a multiple pack, 
DFH.EH contains either a @C@ 
for a continuation or @B@ for a 
base pack. If this is not a multi- 
ple pack file, DFH.EU contains 
the disk drive EU number. 

Contains either the disk pack 
serial number or the address of 
the disk file header area on the 
disk. 



DISK LABEL 

Each pack or cartridge, whether system or removable, contains a label describing its physical characteristics. 
Sectors to 63 are reserved for the disk label and various MCP tables, and are not used for any other pur- 
pose. A disk label is constructed at the time of initialization, gathering data from two sources: 

a. The information provided by the Disk Initializer control card. 

b. The information provided by the Disk Initializer program itself. 
Table 4-3 describes the disk label format. 
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Table 4-3. Disk Pack Label 



Field Name 



01 PACK.LABEL 
02 PL.VOL1 
02 PL.SERIAL.NO 

02 PL.ACCESS.CODE 
02 PL.ID 
03 PL.NAME 

03 PL.FILLER 
02 PL.SYSTEM.INTERCHANGE 



Type 



02 PL.CODE 



02 PL.FILLER 
02 PL.OWNER.ID 

02 PL.TYPE 



02 PL.CONTINUE 



Length 



Char 



Char 
Char 

Char 



Char 



Char 


180 


Char 


J 


Char 


6 


Char 


1 


Char 


17 


Char 


10 


Char 


7 


Char 


2 



Description 



6 
14 



Contains the literal "VOL1 ". 

Contains the disk pack serial 
number supplied by the control 
card. 

Not implemented 

Contains the disk pack identifiers. 

Contains the user-assigned name 
of the disk pack that is on the 
control card. 

Used for label compatibility 
with other electronic units. 

Enables the pack to be formatted 
in such a way as to make it com- 
patible and interchangeable with 
other Burroughs Systems. (Not 
implemented.) 

Contains a when the pack is a 
"scratch pack." 

NOTE: A "scratch pack" is 
defined as a pack that has been 
purged or initialized. A pack 
that simply has had its files 
removed is not considered a 
"scratch pack." 

Reserved. 

Contains the disk pack name 
supplied by initialization control 
card. 

Contains the usage code of the 
disk pack: 

R = Restricted 

S = System 

U = Unrestricted 

Contains a "C" if this is a 
continuation pack. 
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Table 4-3. Disk Pack Label (Cont) 



Field Name 



02 PL.FILLER 

02 PL.INT 

02 PL.VOL2 

02 PL.DATE.INITIALIZED 

02 PL.INIT.SYSTEM 

02 PL.DISK.DIRECTORY 

02 PL.MASTER.AVAIL 

02 PL.DISK.AVAILABLE 

02 PL.INTEGRITY 

02 PL.ERROR.COUNT 



02 PL.SECTORS.XD 

02 PL.TEMP.TABLE 
02 PL.PCD 



Type 



Char 
Char 
Char 
Char 



Char 
Char 

Char 

Char 

Char 

Char 



Length 



Char 



Char 



Char 



26 

1 
4 
5 



Description 



6 
8 



Reserved. 

Always contains a blank. 

Contains the literal "VOL2". 

Contains the date the pack was 
initialized, in Julian format, as 
supplied by the initialization 
control card. 

Contains the literal 17MC33. 

Contains the decimal disk address 
of the Disk Directory. 

Contains the decimal disk address 
of the Master Available table. 

Contains the decimal disk address 
of the Working Available table. 

Indicates either no files are open, 
or one or more files are open. 

Contains a counter containing 
the number of read, write or 
parity errors. The counter is 
imcremented by 1 each time the 
MCP attempts to recover from an 
error. The MCP attempts 20 read/ 
writes before informing the oper- 
ator of the error. This count is 
displayed on the Console Printer 
each time the pack is mounted 
and made Ready. If the count 
increases at a rapid rate, the pack 
and drive should be inspected. 

Contains the number of sectors 
removed by an "XD" console 
input message. 

Contains the decimal disk address 
of the Temporary Available table. 

Contains the port, channel, and 
drive on which this pack is 
mounted. 
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Table 4-3. Disk Pack Label (Cont) 



Field Name 


Type 


Length 


Description 


02 PL.ASSIGNED.TO.BPS 
02 PL.FILLER 


Char 
Char 


6 
30 


Contains the serial number of the 
base pack to which this pack is 
assigned. 

Reserved. 



PACK INFORMATION TABLE 

When a disk pack is on-line, the MCP builds a Pack Information table describing its characteristics and 
maintains its current status while the disk pack is on the system. Table 4-4 describes the Pack Information 
table format. 

Table 4-4. Pack Information Table 



Field Name 



01 PACK.INFOR 
02 P.NAME 

02 P.SERIAL.NO 

02 P.DISK.DIRECTORY 
02 P.DISK .AVAILABLE 
02 P.TEMP.TABLE 
02 P.UNIT.NAME 

02 P.PCD 

03 P.PORT.CHAN 

03 FILLER 

03 P.DRIVE.NO 

02 P.NO.USERS 



Type 



Char 

Char 

Bit 

Bit 
Bit 
Bit 
Bit 

Bit 

Bit 

Bit 
Bit 

Bit 



Length 



373 
10 

24 

36 
36 
36 



12 



1 
4 



Description 



Contains the disk pack name 
assigned at disk initialization. 

Contains the disk pack serial 
number assigned at disk initiali- 
zation. 

Contains the disk address of the 
Disk Directory. 

Contains the disk address of the 
Disk Available table. 

Contains the disk address of the 
Temporary Available table. 

Contains the EU mnemonic 
identifiers of the pack residence. 
For example, DPA or DPB. 

Contains the hardware location 
of the pack. 

Contains the port and channel 
location of the pack. 

Reserved. 

Contains the drive number of the 
pack. 

Contains the number of users 
currently accessing this pack. 
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Table 4-4. Pack Information Table (Cont) 



Field Name 



02 P.NO.MPF.USERS 

02 P.TO.BE.POWERED.DOWN 
02 P.RESTRICTED 



02 P.CONTINUE 

02 P.SCRATCH 
02 P.FULL 

02 FILLER 

02 P.ASSIGNED.TO.BPS 

02 P.BACK.LINK 
02 P.LINK 



Type 



Bit 



Bit 



Bit 



Bit 

Bit 

Bit 

Bit 
Bit 

Bit 
Bit 



Length 



1 

1 

1 

24 

24 
24 



Description 



Contains the total number of 
multiple pack files open on this 
pack. 

Informs the MCP that the pack 
is to be powered down. 

Identifies the type of pack for 
the MCP: 

= System resource pack 

1 = Restricted 

2 = Unrestricted User 

3 = Interchange 

Indicates this is a continuation 
pack for a multiple pack file. 

Indicates this is a scratch pack. 

Indicates no disk space is 
currently available. 

Reserved. 

Contains the base pack serial 
number of a continuation pack. 

Points to the previous Pack 
Information Table entry (back- 
ward link). 

Points to the next Pack Informa- 
tion Table entry (forward link). 



DISK FILE ALLOCATION 

The allocation of disk space is the responsibility of the MCP. When a request is made for space, the MCP 
searches the Working Available table until an area is found that is equal, to or greater than the space 
required. There are times when contiguous space is not available. The MCP then notifies the system 
operator of the insufficient space. This requires operator intervention either to provide the space required 
or to discontinue the program. The MCP cannot assign two or more non-contiguous areas to a space 
request. 

FILE LOOK-UP 

When searching for a file, the MCP uses the sequence illustrated in figure 4-5. 
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Figure 4-5. Disk File Search 
4-14 



DISK FILE CONSTRUCTION 

Files on disk are constructed and addressed either sequentially or randomly. 
Sequential File 

In a sequential file, the records of data are stored on the disk in a consecutive manner based upon a 
sequentially controlled program key. These records are made available to a program sequentially from 
record to record until End-of-File. For example, to locate the 992nd record in a 1000-record file, 
all preceding 991 records must be read and bypassed prior to accessing the 992nd record. 

Random File 

The random file is a storage technique by which the program must only pass the relative record number 
desired, referred to as the key, to the MCP. The MCP then takes the key and, by calculation, arrives 
at the disk address. This method allows the selection of any record in the file by a single read/write 
operation. 

AVAILABLE TABLES 

The MCP maintains three tables which reference all available disk space. 

a. Master Available table. 

b. Working Available table. 

c. Temporary Available table. 

Master Available Table 

The Master Available table, constructed at disk initialization, reflects all areas of the disk that can be utilized 
for the storing of data. The following criteria determine the physical acceptability of the pack transition 
to be used on the system. 

a. Addresses through 63 must be free of read/write errors. 

b. The maximum number of read/write errors for addresses greater than 63 cannot be exceed 71 . 

The Master Available table consists of three contiguous disk segments. It references and maintains the 
total available disk area in disk address sequence. 

The Master Available table for head-per-track is created by COLDSTART. 

Working Available Table 

The Working Available table (referred to as the Available table) contains the addresses and sizes of all disk 
areas not allocated either to a user program or to the MCP. The Working Available table is in the same for- 
mat as the Master Available table, having a length of 10 segments and expanded when necessary. When 
entries are made in the Disk Directory, the space reflected in the disk file header is removed from the 
Working Available table. Note that the entries in the Disk Directory plus those in the Working Available 
table can total an amount less than the total amount of disk space specified in the Master Available 
table. This occurs when the MCP temporarily obtains disk space without creating a Disk Directory entry. 

Temporary Available Table 

The Temporary Available table references those areas on disk that are being used but are not entered 
in the Disk Directory or the Working Available table. Areas that are "temporary" are those that are 
currently being used by a program or the MCP. When a file is made permanent, the space is removed 
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from the Temporary Available table and entered into the Disk Directory. Some examples of the disk 
space appearing in the Temporary Available table, but not in the Disk Directory or the Working 
Available table, are the following: 

a. Space allocated for a new disk file. 

b. Program roll-out areas. 

c. Program work files. 

The Temporary Available table uses five segments, expanded when necessary. New entries are placed in the 
first available position. Table 4-5 describes the Master, Working, and Temporary Available table format. 



Table 4-5. Master, Working, and Temporary Available Tables 



Field Name 


Type 


Length 


Description 


01 DISK.AVAILABLE.TABLE 


Bit 


1440 




02 AVL.FOR.LINK 


Bit 


36 


Contains the disk address of the 
next available segment. If this is 
the last entry in the table, this 
field contains zeros (forward 
link). 


02 AVL.BACK.LINK 


Bit 


36 


Contains the disk address of the 
previous entry in the table. When 
this is the first entry in the table, 
this field contains zeros (back- 
ward link). 


02 AVL.SELF 


Bit 


36 


Contains the disk address of this 
entry. 


02 FILLER 


Bit 


4 


Reserved. 


02 AVL.BLOCK 


Bit 


60 


Reserved. 


03 AVL.ADDRESS 


Bit 


36 


Contains the disk address of the 
next available disk area. 


03 A VL. LENGTH 


Bit 


24 


Contains the length of the area 
which AVL.ADDRESS refer- 
ences. There is a maximum of 
22 entries per segment. 



MULTIPLE PACK FILES 

A multiple pack file is a file that may be contained on one or more removable disk packs. The file 
originates on a "base" pack and can continue to a maximum of 15 packs. These packs are called 
"continuation" packs. A multiple pack file can have only one base pack, and must be on-line for all 
opens and closes performed on the file. 
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The base pack can contain either single and multiple pack type files but cannot contain continuation files 
associated with another base pack. The disk pack header on the base pack retains all information con- 
cerning the file, which includes the addresses that are assigned to that file and the serial number of each 
continuation pack. 

When a multiple pack file requires additional space to store data, the MCP searches for another continuation 
pack associated with the same base pack. If a continuation pack is not available, the MCP searches for a 
scratch pack of the same processing type (restricted, unrestricted) as the base pack. If one is available, 
that pack is assigned as a continuation pack for that file. 

Multiple Pack File Information Table 

When an input multiple pack file is opened, the file header is read into memory from the base pack; with 
output files, the header is constructed by the MCP in memory. The MCP then obtains space on the system 
pack for a Multiple Pack File Information table, containing the information associated with that multiple 
pack file. The table contains base pack information, and a copy of the disk file header. Table 4-6 
describes the Multiple Pack File Information table format. 



Table 4-6. Multiple Pack File Information Table 



Field Name 



01 MPF.INFO.TABLE 
02 MPF.FORWARD 

02 MPF.BACKWARD 

02 MPF.SELF 

02 MPF.NAME 

02 MPF.HEADER.SIZE 

02 MPF.HEADER.ADDRESS 

02 MPF.BPS.NO 

02 MPF.OPEN.TYPE 

02 MPF.NEW.FILE 
02 MPF.NEW.AREA 



Type 



Bit 
Bit 

Bit 

Bit 

Char 

Bit 



Length 



Bit 



Bit 



Bit 



Bit 



Bit 



1392 
36 

36 

36 

30 

24 
24 
24 



Description 



Points to the next multiple pack 
file entry. 

Points to the previous multiple 
pack file entry. 

Points to this multiple pack 
file entry. 

Contains the multiple pack 
file-identifier. 

Contains the size of composite 
file header. 

Points to the composite file 
header in memory. 

Contains the base pack serial 
number. 

Contains the type of file opened. 
(Same as the DFH.OPEN.TYPE 
in the Disk File Header table.) 

Indicates that this is a newly 
created disk file. 

Indicates that this is a newly 
created disk area. 
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Table 4-6. Multiple Pack File Information Table (Cont) 



Field Name 



02 MPF.CS 

02 FILLER 

02 MPF.BASE.PACK.TYPE 



02 MPF.ARRAY 



03 MPF.ONLINE 



04 MPF.SERIAL.NO 
04 MPF.HDR.DSK 



Type 



Bit 

Bit 
Bit 



Bit 

Bit 



Length 



1 
4 



24 



36 



Description 



Indicates that a Clear/Start was 
or was not performed since this 
entry was created. 



Contains the processing pack 
type. 

1 = Restricted 

2 = Unrestricted 

Used to record all continuation 
packs that are on-line. 

Contains a maximum of 1 6 
items in this array. 

Contains the serial number of 
the pack. 

Contains the disk address of the 
disk file header. 



MCP Composite Header 

The MCP builds a composite header in memory for each multiple pack file opened. Each address in the 
header contains one of two items : 

a. If the pack is on-line, it contains the absolute disk address of that area. 

b. If the pack is off-line, it contains the serial number of the pack on which the area resides. 
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